NaT

Описание

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

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

пример

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

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

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

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

пример

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

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

Примеры

свернуть все

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

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

Создайте массив NaT 2 на 3 Значениями и укажите формат даты.

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

Назначение datetime значение элементу t.

t(1,2) = datetime('today')
t = 2x3 datetime
   NaT          23/03/2021   NaT       
   NaT          NaT          NaT       

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

свернуть все

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

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

  • Если 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 массив в универсальном скоординированном времени, на который приходится високосное время. Список секунд скачка, поддерживаемых datetime тип данных, см. leapseconds.

  • 'local', для создания datetime массив в системном часовом поясе.

В этой таблице перечислены некоторые общие имена областей часовых поясов из базы данных временных зон IANA.

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

Расширенные возможности

Генерация кода C/C + +
Сгенерируйте код C и C++ с помощью Coder™ MATLAB ®

.

См. также

| | |

Введенный в R2015b