isnat

Determine NaT (Not-a-Time) elements

Syntax

tf = isnat(A)

Description

tf = isnat(A) returns an array the same size as the datetime array, A, containing logical 1 (true) where the elements of A are Not-a-Time (NaTs) and logical 0 (false) where they are not. NaT represents a datetime that is undefined.

Examples

Determine If Array Elements are NaT

Create a datetime array from numeric values containing NaN.

d = datetime(2014,[1 2 NaN 4],1)

d = 1x4 datetime
   01-Jan-2014   01-Feb-2014   NaT           01-Apr-2014

Determine if any elements of d are NaT (Not-a-Time).

isnat(d)

ans = 1x4 logical array

   0   0   1   0

Input Arguments

A — Input array

datetime array

Input array, specified as a datetime array.

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

The isnat function fully supports tall arrays. For more information, see Tall Arrays.

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced in R2014b