# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

# NaT

`NaT` is the representation for Not-a-Time, a value that can be stored in a `datetime` array to indicate an unknown or missing `datetime` value.

The `datetime` function creates a `NaT` value automatically when it cannot convert text to a `datetime` value, or for elements in a `datetime` array where the `Year`, `Month`, `Day`, `Hour`, `Minute`, or `Second` properties are set to `NaN`. You also can assign the character vector, `'NaT'`, to elements of an existing `datetime` array. Use the `NaT` function to create a new `datetime` array containing only `NaT` values.

## Syntax

``NaT``
``t = NaT(n)``
``t = NaT(sz1,...,szN)``
``t = NaT(sz)``
``t = NaT(___,'Format',fmt)``
``t = NaT(___,'TimeZone',tz)``

## Description

example

``NaT` returns a scalar Not-a-Time (`NaT`) `datetime` value.`
````t = NaT(n)` returns an `n`-by-`n` matrix of `NaT` values.```
````t = NaT(sz1,...,szN)` returns a `sz1`-by-...-by-`szN` array of `NaT` values where `sz1,...,szN` indicates the size of each dimension. For example, `NaT(3,4)` returns a 3-by-4 array of `NaT` values.```
````t = NaT(sz)` returns an array of `NaT` values where the size vector, `sz`, defines `size(t)`. For example, `NaT([3,4])` returns a 3-by-4 array of `NaT` values.```

example

````t = NaT(___,'Format',fmt)` returns a `datetime` array with the specified display format. Use this syntax to initialize a `datetime` array. Not-a-Time values always display as `NaT`, but non-`NaT` values assigned to the array will display using the specified format.```
````t = NaT(___,'TimeZone',tz)` returns an array of `NaT` values in the time zone specified by `tz`.```

## Examples

collapse all

Create a 3-by-3 matrix of `NaT` values.

`t = NaT(3)`
```t = 3x3 datetime array NaT NaT NaT NaT NaT NaT NaT NaT NaT ```

Create a 2-by-3 array of `NaT` values and specify a date format.

`t = NaT(2,3,'Format','dd/MM/yyyy')`
```t = 2x3 datetime array NaT NaT NaT NaT NaT NaT ```

Assign a `datetime` value to an element of `t`.

`t(1,2) = datetime('today')`
```t = 2x3 datetime array NaT 01/09/2017 NaT NaT NaT NaT ```

## Input Arguments

collapse all

Size of square matrix, specified as an integer.

• If `n` is `0`, then `t` is an empty matrix.

• If `n` is negative, then it is treated as `0`.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

Size of each dimension, specified as separate arguments of integer values.

• If the size of any dimension is `0`, then `t` is an empty array.

• If the size of any dimension is negative, then it is treated as `0`.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

Size of each dimension, specified as a row vector of integer values. Each element of this vector indicates the size of the corresponding dimension:

• If the size of any dimension is `0`, then `t` is an empty array.

• If the size of any dimension is negative, then it is treated as `0`.

Example: `sz = [2,3,4]` creates a 2-by-3-by-4 array.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

Date format, specified as a character vector. Use the letters `A-Z` and `a-z` to define the format. For a complete list of valid letter identifiers, see the `Format` property for datetime arrays.

Alternatively, use one of the following character vectors to specify a default format.

Value of `fmt`Description

`'default'`

Use the default display format.

`'defaultdate'`

Use the default display format for datetime values created without time components.

Example: `'yyyy MMM dd'`

Data Types: `char`

Time zone region, specified as a character vector.

The value of `tz` can be:

• `''`, to create an “unzoned” `datetime` array that does not belong to a specific time zone.

• The name of a time zone region from the IANA Time Zone Database, for example, `'America/Los_Angeles'`. The name of a time zone region accounts for the current and historical rules for standard and daylight offsets from UTC that are observed in a geographic region.

• An ISO 8601 character vector of the form `+HH:mm` or `-HH:mm`, for example, `'+01:00'`, to specify a time zone that is a fixed offset from UTC.

• `'UTC'`, to create a `datetime` array in Universal Coordinated Time.

• `'UTCLeapSeconds'`, to create a `datetime` array in Universal Coordinated Time that accounts for leap seconds.

• `'local'`, to create a `datetime` array in the system time zone.

This table lists some common names of time zone regions from the IANA Time Zone Database.

Value of `TimeZone`UTC OffsetUTC DST Offset
`'Africa/Johannesburg'`+02:00+02:00
`'America/Chicago'`−06:00−05:00
`'America/Denver'`−07:00−06:00
`'America/Los_Angeles'`−08:00−07:00
`'America/New_York'`−05:00−04:00
`'America/Sao_Paulo'`−03:00−02:00
`'Asia/Hong_Kong'`+08:00+08:00
`'Asia/Kolkata'`+05:30+05:30
`'Asia/Tokyo'`+09:00+09:00
`'Australia/Sydney'`+10:00+11:00
`'Europe/London'`+00:00+01:00
`'Europe/Zurich'`+01:00+02:00

Data Types: `char`