NaT

Не является временем

Описание

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

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

пример

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

t = NaT(n) возвращает n- 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
   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Смещение 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

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

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

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

| | |

Введенный в R2015b
Для просмотра документации необходимо авторизоваться на сайте