NAT

NaT является представлением для Not-Time, значение, которое может храниться в массиве datetime, чтобы указать на неизвестное или недостающее значение datetime.

Функция datetime автоматически создает значение NaT, когда она не может преобразовать текст в значение datetime, или для элементов в массиве datetime, где Year, Month, Day, Hour, Minute или свойства Second установлены в NaN. Также можно присвоить вектор символов, 'NaT', к элементам существующего массива datetime. Используйте функцию NaT, чтобы создать новый массив datetime, содержащий только значения NaT.

Синтаксис

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

Описание

пример

NaT возвращает скалярный Not-Time (NaT) значение datetime.

t = NaT(n) возвращает n-by-n матрица значений NaT.

t = NaT(sz1,...,szN) возвращает sz1...-by-szN массивом значений NaT, где sz1,...,szN указывает на размер каждой размерности. Например, NaT(3,4) возвращает массив 3 на 4 значений NaT.

t = NaT(sz) возвращает массив значений NaT, где вектор размера, sz, задает size(t). Например, NaT([3,4]) возвращает массив 3 на 4 значений NaT.

пример

t = NaT(___,'Format',fmt) возвращает массив datetime с заданным форматом отображения. Используйте этот синтаксис, чтобы инициализировать массив datetime. Значения Not-Time всегда отображаются как NaT, но non-NaT значения, присвоенные массиву, отобразят использование заданного формата.

t = NaT(___,'TimeZone',tz) возвращает массив значений NaT в часовом поясе, заданном tz.

Примеры

свернуть все

Создайте 3х3 матрицу значений NaT.

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

Создайте массив 2х3 значений NaT и задайте формат даты.

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

Присвойте значение datetime элементу t.

t(1,2) = datetime('today')
t = 2x3 datetime array
   NaT          21/02/2019   NaT       
   NaT          NaT          NaT       

Входные параметры

свернуть все

Размер квадратной матрицы, заданной как целое число.

  • Если n является 0, то t является пустой матрицей.

  • Если n отрицательно, это эквивалентно n = 0.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Размер каждой размерности, заданной в качестве отдельных аргументов целочисленных значений.

  • Если размером какой-либо размерности является 0, то t является пустым массивом.

  • Если размер какой-либо размерности отрицателен, то это обработано как 0.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Размер каждой размерности, заданной как вектор - строка из целочисленных значений. Каждый элемент этого вектора указывает на размер соответствующей размерности:

  • Если размером какой-либо размерности является 0, то t является пустым массивом.

  • Если размер какой-либо размерности отрицателен, то это обработано как 0.

Пример: sz = [2,3,4] создает 2 массивом 3 на 4.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Формат даты, заданный как вектор символов или скаляр строки. Используйте буквы A-Z и a-z, чтобы задать формат. Для полного списка допустимых идентификаторов буквы смотрите свойство Format для массивов datetime.

Также используйте один из следующих векторов символов, чтобы задать формат по умолчанию.

Значение fmtОписание

'default'

Используйте формат отображения по умолчанию.

'defaultdate'

Используйте формат отображения по умолчанию для стоимости datetime, созданной без компонентов времени.

Пример: 'yyyy MMM dd'

Типы данных: char | string

Область часового пояса, заданная как вектор символов или скаляр строки.

Значение tz может быть:

  • '', чтобы создать “незонный” массив datetime, который не принадлежит определенному часовому поясу.

  • Имя области часового пояса от Базы данных Часового пояса IANA, например, 'America/Los_Angeles'. Имя области часового пояса составляет текущие и исторические правила для стандарта и смещений дневного света от UTC, которые наблюдаются в географической области.

  • Вектор символов ISO 8601 формы +HH:mm или -HH:mm, например, '+01:00', чтобы задать часовой пояс, который является фиксированным смещением от UTC.

  • 'UTC', чтобы создать массив datetime в универсальное время.

  • 'UTCLeapSeconds', чтобы создать массив datetime в универсальное время, которое считает в течение секунд прыжка.

  • 'local', чтобы создать массив datetime в зоне системного времени.

Эта таблица приводит некоторые общие названия областей часового пояса от Базы данных Часового пояса IANA.

Значение TimeZoneСмещение UTCСмещение DST UTC
'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

Типы данных: char | string

Смотрите также

| |

Введенный в R2015b