Exponenta Banner
exponenta event banner

NaT

Не-а-время

свернуть все на странице

Синтаксис

NaT
t = NaT (n)
t = NaT (sz1,...,szN)
t = NaT (sz)
t = NaT (___, 'Формат', fmt)
t = NaT (___, 'TimeZone', tz)

Описание

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около-n матрица NaT значения.

t = NaT(sz1,...,szN) возвращает sz1-by-... -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-a-Time всегда отображаются как NaT, но не -NaT значения, назначенные массиву, будут отображаться в указанном формате.

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

Примеры

свернуть все

Открыть сценарий в реальном времени

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

t = NaT(3)
t = 3x3 datetime
   NaT   NaT   NaT
   NaT   NaT   NaT
   NaT   NaT   NaT
Открыть сценарий в реальном времени

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

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++ с помощью MATLAB ® Coder™

.

См. также

| | |

Представлен в R2015b

Документация MATLAB

Поддержка