bat365 Homepage

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.

example

Examples

collapse all

Determine If Array Elements are NaT

Open Live Script

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

collapse all

`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

isnat

Syntax

Description

Examples

Determine If Array Elements are NaT

Input Arguments

A — Input array datetime array

Extended Capabilities

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

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.

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