Массивы, которые представляют моменты времени
datetime
массивы представляют моменты времени с помощью преждевременного календаря ISO. datetime
значения имеют гибкие форматы отображения до точности наносекунды и могут составлять часовые пояса, летнее время и секунды прыжка.
возвращает скалярный t
= datetimedatetime
массив, соответствующий текущей дате и время.
использует дату, заданную t
= datetime(relativeDay
)relativeDay
. relativeDay
введите может быть 'today'
, 'tomorrow'
, 'yesterday'
, или 'now'
.
создает массив значений datetime из текста в t
= datetime(DateStrings
)DateStrings
представление моментов времени.
интерпретирует t
= datetime(DateStrings
,'InputFormat',infmt
)DateStrings
использование формата задано infmt
. Все значения во входном параметре DateStrings
должен иметь тот же формат.
Чтобы избежать неоднозначностей между аналогичными форматами, задайте 'InputFormat'
и его соответствующее значение, infmt
.
Управлять форматом отображения t
, задайте 'Format'
аргумент пары "имя-значение" или набор Format
свойство t
.
создает вектор-столбец значений datetime от векторов даты в t
= datetime(DateVectors
)DateVectors
.
создает массив значений datetime для соответствующих элементов t
= datetime(Y,M,D
)Y
M
, и D
(год, месяц, день) массивы. Массивы должны быть одного размера (или любой может быть скаляром). Также можно задать входные параметры как вектор даты, [Y M D]
.
также создает t
= datetime(Y,M,D,H,MI,S
)H
, MI
, и S
(час, минута, и второй) массивы. Все массивы должны быть одного размера (или любой может быть скаляром). Также можно задать входные параметры как вектор даты, [Y M D H MI S]
.
добавляет t
= datetime(Y,M,D,H,MI,S,MS
)MS
(миллисекунда) массив. Все массивы должны быть одного размера (или любой может быть скаляром).
преобразует числовые значения в t
= datetime(X
,'ConvertFrom',dateType
)X
к datetime
массив t
. dateType
аргумент задает тип значений в X
.
Если X
содержит времена POSIX® или даты Джулиана, которые представляют местное время, затем задают зону подходящего времени для t
использование 'TimeZone'
аргумент пары "имя-значение". Если вы не задаете часовой пояс, то времена POSIX или даты Джулиана в X
обработаны как времена UTC, не местное время.
задает дополнительные опции с помощью одного или нескольких аргументов пары "имя-значение", в дополнение к любому из входных параметров в предыдущих синтаксисах. Например, можно задать формат отображения t
= datetime(___,Name,Value
)t
использование 'Format'
аргумент пары "имя-значение".
Для лучшей эффективности при создавании стоимости datetime из текста задайте любой 'Format'
или 'InputFormat'
и его соответствующее значение, infmt
.
relativeDay
— День относительно текущей даты'yesterday'
| 'today'
| 'tomorrow'
| 'now'
День относительно текущей даты в виде одного из следующих значений.
Значение relativeDay | Описание |
---|---|
'yesterday' | Дата предыдущего дня, в полночь |
'today' | Текущая дата, в полночь |
'tomorrow' | Дата следующего дня, в полночь |
'now' | Текущая дата и время |
DateStrings
— Текст, представляющий даты и временаТекст, представляющий даты и времена в виде символьного массива, массива ячеек из символьных векторов или массива строк. datetime
функционируйте сначала пытается совпадать с форматом DateStrings
к распространенным форматам. Если вы знаете формат, задаете 'InputFormat'
и его соответствующий infmt
значение или 'Format'
аргумент пары "имя-значение".
Пример: '24-Oct-2014 12:45:07'
Пример: {'15-Oct-2013','20-Nov-2014'}
Пример: ["11-Nov-2016","12-Dec-2016"]
Типы данных: char |
cell
| string
infmt
— Формат входного текстаФормат входного текста, представляющего даты и времена в виде вектора символов или строкового скаляра, который содержит идентификаторы буквы:
Если infmt
не включает спецификатор даты, затем datetime
принимает что значения в DateStrings
происходите в течение текущего дня.
Если infmt
не включает спецификатор времени, затем datetime
принимает что значения в DateStrings
происходите в полночь.
Эта таблица показывает несколько общих форматов ввода и включает примеры отформатированного входа для даты, суббота, 19 апреля 2014 в 9:41:06.12345 PM в Нью-Йорке.
Значение infmt | Пример |
---|---|
'yyyy-MM-dd' | 2014-04-19
|
'dd/MM/yyyy' | 19/04/2014
|
'dd.MM.yyyy' | 19.04.2014
|
'yyyy年 MM月 dd日' | 2014年 04月 19日 (Символы для японской локали, ja_JP ) |
'MMMM d, yyyy' | April 19, 2014 |
'eeee, MMMM d, yyyy h:mm a' | Saturday, April 19, 2014 9:41 PM |
'MMMM d, yyyy HH:mm:ss Z' | April 19, 2014 21:41:06 -0400 |
'yyyy-MM-dd''T''HH:mmXXX' | 2014-04-19T21:41-04:00 |
'yyyy-MM-dd HH:mm:ss.SSS' | 2014-04-19 21:41:06.123
|
Для входного текста, который представляет доли секунды, можно задать infmt
максимум с девятью S
символы, чтобы указать на цифры доли секунды. Например, 'yyyy-MM-dd HH:mm:ss.SSS'
формат для текста, который представляет даты и времена точности миллисекунды.
Для полного списка допустимых идентификаторов буквы смотрите Format
свойство для массивов datetime.
Примечание
Идентификаторы буквы это datetime
принимает отличаются от идентификаторов, используемых datestr
, datenum
, и datevec
функции.
Типы данных: char |
string
DateVectors
DateVectors Векторы даты в виде m
- 6 или m
- 3 матрицы, содержащие m
полные или частичные векторы даты, соответственно. Полный вектор даты имеет шесть элементов, задавая год, месяц, день, час, минуту, и во-вторых, в том порядке. Частичный вектор даты имеет три элемента, задавая год, месяц и день, в том порядке. Каждый элемент DateVector
должно быть положительное или отрицательное целочисленное значение за исключением элемента секунд, который может быть дробным. Если элемент выходит за пределы обычной области значений, datetime
настраивает и тот элемент вектора даты и предыдущий элемент. Например, если мелким элементом является 70
, затем datetime
настраивает элемент часов 1
и устанавливает мелкий элемент на 10
. Если мелким элементом является-15
, затем datetime
уменьшает элемент часов 1
и устанавливает мелкий элемент на 45
.
Пример: [2014 10 24 12 45 07]
Пример: [2014 10 24]
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Y,M,D
— Год, месяц и дневные массивыГод, месяц и дневные массивы, заданные как числовые массивы. Эти массивы должны быть одного размера, или любой может быть скаляром. Y,M,D
должны быть целочисленные значения.
Если Y,M,D
все скаляры или все вектор-столбцы, затем можно задать входные параметры как вектор даты, [Y M D]
.
Если элемент Y
M
, или D
входные параметры выходят за пределы обычной области значений, затем datetime
настраивает и тот элемент и тот же элемент предыдущего входа. Для получения дополнительной информации см. описание для DateVectors
входной параметр.
Пример: 2003,10,24
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Y,M,D,H,MI,S
— Год, месяц, день, час, минута и вторые массивыГод, месяц, день, час, минута и вторые массивы, заданные как числовые массивы. Эти массивы должны быть одного размера, или любой может быть скаляром. Задайте доли секунды как часть входа секунд, S
. Y,M,D,H,MI
массивы должны содержать целочисленные значения.
Если Y,M,D,H,MI,S
все скаляры или все вектор-столбцы, затем можно задать входные параметры как дату vector[Y M D H MI S]
.
Если элемент Y
M
D
H
, MI
, или S
входные параметры выходят за пределы обычной области значений, затем datetime
настраивает и тот элемент и тот же элемент предыдущего входа. Для получения дополнительной информации см. описание для DateVectors
входной параметр.
Пример: 2003,10,24,12,45,07.451
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Y,M,D,H,MI,S,MS
— Год, месяц, день, час, минута, во-вторых, и массивы миллисекундыГод, месяц, день, час, минута, во-вторых, и массивы миллисекунды в виде числовых массивов. Эти массивы должны быть одного размера, или любой может быть скаляром. Y,M,D,H,MI,S
массивы должны содержать целочисленные значения. MS
может содержать дробные миллисекунды.
Если элемент Y
M
D
H
, MI
S
, или MS
входные параметры выходят за пределы обычной области значений, затем datetime
настраивает и тот элемент и тот же элемент предыдущего входа. Для получения дополнительной информации см. описание для DateVectors
входной параметр.
Пример: 2003,10,24,12,45,07,10.52
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
X
— Числовые значенияЧисловые значения в виде массива.
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
dateType
— Тип значений в X
'datenum'
| 'excel'
| 'excel1904'
| 'juliandate'
| ...Тип значений в X
В виде одного из этих значений.
Значение | Тип значений в |
---|---|
|
Номер дней с 0 января 0000 (преждевременный календарь ISO). |
| Номер дней с 0 января 1900. Числа даты Excel® округлены к ближайшей микросекунде. Примечание: Excel неправильно принимает, что год 1900 является високосным годом. Поэтому, когда вычислительные числа даты Excel там являются разрывом одного дополнительного дня между 28 февраля 1900 и 1 марта 1900. |
| Номер дней с 0 января 1904. Числа даты Excel округлены к ближайшей микросекунде. Примечание: Excel неправильно принимает, что год 1900 является високосным годом. Поэтому, когда вычислительные числа даты Excel там являются разрывом одного дополнительного дня между 28 февраля 1900 и 1 марта 1900. |
|
Номер дней с полудня UTC 24 ноября 4714 BCE (преждевременный Григорианский календарь). Если вы преобразуете Пример: преобразуйте T = datetime(X,'ConvertFrom','juliandate',... 'TimeZone','America/New_York') Затем можно преобразовать T.TimeZone = '' |
|
Номер дней с полуночи UTC 17 ноября 1858. Если вы преобразуете Пример: преобразуйте T = datetime(X,'ConvertFrom','modifiedjuliandate',... 'TimeZone','America/New_York') Затем можно преобразовать T.TimeZone = '' |
|
Номер секунд с 1 января 1970 0:00:00 UTC, не считая секунды прыжка. Если вы преобразуете Пример: преобразуйте T = datetime(X,'ConvertFrom','posixtime',... 'TimeZone','America/New_York') Затем можно преобразовать T.TimeZone = '' |
|
Даты как числовые значения YYYYMMDD. Например, |
| Количество "тактов системных часов" с 1 января 1900 0:00:00 UTC, где каждый такт системных часов 2^-32 секунды. |
| Количество "тактов системных часов" с 1 января 0001 0:00:00 UTC, где каждый такт системных часов составляет 100 нс. |
| Количество "тактов системных часов" с 1 января 1601 0:00:00 UTC, где каждый такт системных часов составляет 100 нс. |
| Номер секунд с эпохи. Необходимо также задать Пример: Возвратите номер дней с 1 января 2000. T = datetime(X,'ConvertFrom',... 'epochtime','Epoch','2000-01-01') |
| Количество "тактов системных часов" с эпохи. В дополнение к определению Пример: Возвратите номер дней с 1 января 2000, где T = datetime(X,'ConvertFrom',... 'epochtime','Epoch','2000-01-01','TicksPerSecond',1000) |
Задайте дополнительные разделенные запятой пары Name,Value
аргументы. Name
имя аргумента и Value
соответствующее значение. Name
должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN
.
'Format','eeee MMMM d, y','TimeZone','local'
применяет формат отображения к значениям datetime и задает зону местного времени.'Format'
Формат отображения'default'
| 'preserveinput'
| вектор символов | строковый скалярФормат отображения значений в выходном массиве в виде разделенной запятой пары, состоящей из 'Format'
и одно из следующих значений.
Значение Format | Описание |
---|---|
|
Используйте формат отображения по умолчанию. |
|
Используйте формат, заданный форматом ввода, |
вектор символов или строковый скаляр | Используйте формат, который вы задаете с вектором символов или строковым скаляром. |
Если вы задаете свой собственный формат, то необходимо использовать допустимые идентификаторы буквы. Для полного списка допустимых идентификаторов буквы смотрите Format
свойство.
Формат заводской настройки зависит от вашей системной локали. Чтобы изменить формат отображения по умолчанию, смотрите Формат datetime По умолчанию.
Если вы задаете DateStrings
введите, но не задавайте 'InputFormat'
параметр, затем datetime
попытки использовать Format
значение, чтобы интерпретировать DateStrings
.
Пример: 'Format','eeee, MMMM d, yyyy HH:mm:ss'
отображает дату и время, такую как Wednesday, April 9, 2014 21:41:06
.
Типы данных: char |
string
'Locale'
— Локаль DateStrings
Локаль DateStrings
значения входного параметра в виде разделенной запятой пары, состоящей из 'Locale'
и вектор символов или строковый скаляр. Locale
значение определяет как datetime
интерпретирует DateStrings
. Однако это не определяет как выход datetime
отображение значений.
Locale
значение может быть:
'system'
, задавать вашу системную локаль.
Вектор символов или строковый скаляр в форме
, где xx
_YY
xx
строчный ISO 639-1 двухбуквенный код, который задает язык и YY
прописная альфа ISO 3166-1 2 кода, которые задают страну.
Эта таблица приводит некоторые общие значения для локали.
Локаль | Язык | Страна |
---|---|---|
'de_DE' | Немецкий язык | Германия |
'en_GB' | Английский язык | Соединенное Королевство |
'en_US' | Английский язык | Соединенные Штаты |
'es_ES' | Испанский язык | Испания |
'fr_FR' | Французский язык | Франция |
'it_IT' | Итальянский язык | Италия |
'ja_JP' | Японский язык | Япония |
'ko_KR' | Корейский язык | Корея |
'nl_NL' | Нидерландский язык | Нидерланды |
'zh_CN' | Китайский язык (упрощен) | Китай |
Можно использовать 'Locale'
пара "имя-значение" только, когда вы используете DateStrings
входной параметр.
Пример: 'Locale','de_DE'
Примечание
Locale
значение определяет, как интерпретированы входные текстовые значения. Выходные значения datetime всегда отображаются на языке, заданном опцией Локали в разделе формата Datetime панели Настроек.
Чтобы изменить локаль datetime по умолчанию для отображения, см. Настройку параметров командного окна.
Чтобы преобразовать значения datetime в текст с помощью различной локали, используйте char
, cellstr
, или string
функции.
Типы данных: char |
string
'PivotYear'
— Запустите год 100-летнего диапазона датyear(datetime('now'))-50
(значение по умолчанию) | целое числоЗапустите год 100-летнего диапазона дат, в котором 2D символьный год находится в виде разделенной запятой пары, состоящей из 'PivotYear'
и целое число. Используйте год центра, чтобы интерпретировать даты, которые задают год как два символа. Таким образом, год центра оказывает влияние только когда infmt
аргумент включает y
или yy
.
Можно использовать 'PivotYear'
пара "имя-значение" только, когда вы используете DateStrings
входной параметр.
Пример: 'PivotYear',1900
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
'TimeZone'
TimeZone ''
(значение по умолчанию) | вектор символов | строковый скалярЧасовой пояс в виде разделенной запятой пары, состоящей из 'TimeZone'
и вектор символов или строковый скаляр, который задает часовой пояс.
datetime
функционируйте использует значение 'TimeZone'
интерпретировать входные данные и установить TimeZone
свойство выходного массива. Если входные данные являются векторами символов или строками, которые включают часовой пояс, то datetime
функция преобразует все значения в зону требуемого времени.
Для получения дополнительной информации и список часовых поясов, смотрите TimeZone
свойство.
Типы данных: char |
string
Format
Формат отображения'default'
| вектор символов | строковый скалярФормат отображения в виде 'default'
, вектор символов или строковый скаляр.
Значение Format | Описание |
---|---|
|
Используйте формат отображения по умолчанию. |
вектор символов или строковый скаляр | Используйте формат, который вы задаете с вектором символов или строковым скаляром. |
Если вы задаете собственный формат, то он должен использовать допустимые идентификаторы буквы, которые соответствуют Unicode® Locale Data Markup Language (LDML) стандарт в течение многих дат и времен.
Пример: 'eeee, MMMM d, yyyy HH:mm:ss'
отображает дату и время, такую как Wednesday, April 9, 2014 21:41:06
.
Чтобы разделить поля, можно включать символы небуквы, такие как дефис, пробел, двоеточие или любые символы non-ASCII. Включать буквы A-Z
и a-z
как буквенные символы в формате, заключите их в одинарные кавычки.
Пример: 'uuuu-MM-dd''T''HH:mm:ss'
отображает дату и время, такую как 2014-04-09T21:41:06
.
Примечание
Идентификаторы буквы это datetime
принимает отличаются от идентификаторов, используемых datestr
, datenum
, и datevec
функции.
Формат заводской настройки зависит от вашей системной локали. Чтобы изменить формат отображения по умолчанию, смотрите Формат datetime По умолчанию.
Эта таблица приводит общие форматы отображения. Примеры показывают отформатированный вывод для даты, среда, 9 апреля 2014 в 9:41:06.12345 PM, в Нью-Йорке.
Значение Format | Пример |
---|---|
'yyyy-MM-dd' | 2014-04-09
|
'dd/MM/yyyy' | 09/04/2014
|
'dd.MM.yyyy' | 09.04.2014
|
'yyyy年 MM月 dd日' | 2014年 04月 09日 (Символы для японской локали, ja_JP ) |
'MMMM d, yyyy' | April 9, 2014 |
'eeee, MMMM d, yyyy h:mm a' | Wednesday, April 9, 2014 9:41 PM |
'MMMM d, yyyy HH:mm:ss Z' | April 9, 2014 21:41:06 -0400 |
'yyyy-MM-dd''T''HH:mmXXX' | 2014-04-09T21:41-04:00 |
'yyyy-MM-dd HH:mm:ss.SSS' | 2014-04-09 21:41:06.123
|
Используйте эти идентификаторы, чтобы задать форматы отображения полей даты и времени. Форматы отображения выход show для даты, среда, 9 апреля 2014 в 9:41:06.12345 PM, в Нью-Йорке.
Обозначьте буквами идентификатор | Описание | Отображение |
---|---|---|
G | Эра | CE |
y | Год, без начальных нулей. Смотрите, Обратите внимание на то, что следует этой таблице. | 2014
|
yy | Год, с помощью последних двух цифр. Смотрите, Обратите внимание на то, что следует этой таблице. | 14
|
yyy , yyyy ... | Год, с помощью, по крайней мере, количество цифр задан количеством экземпляров 'y' | В течение года 2014, 'yyy' отображения 2014 , в то время как 'yyyyy' отображения 02014 . |
u , uu , ... | Год ISO. Один номер, определяющий год. Значение года ISO присваивает положительные значения годам CE и отрицательные величины к годам BCE с 1 BCE быть годом 0. | 2014
|
Q | Четверть, с помощью одной цифры | 2
|
QQ | Четверть, с помощью двух цифр | 02
|
QQQ | Четверть, сокращенная | Q2 |
QQQQ | Четверть, полное имя | 2nd quarter |
M | Месяц, числовое использование одной или двух цифр | 4
|
MM | Месяц, числовое использование двух цифр | 04
|
MMM | Месяц, сокращенное имя | Apr |
MMMM | Месяц, полное имя | April |
MMMMM | Месяц, использованный для своей выгоды сначала, обозначает буквами | A |
W | Неделя месяца, с помощью одной цифры | 2
|
d | День месяца, с помощью одной или двух цифр | 9
|
dd | День месяца с помощью двух цифр | 09
|
D | День года, с помощью один, два, или три цифры | 99
|
DD | День года с помощью двух цифр | 99
|
DDD | День года с помощью трех цифр | 099
|
e | День недели (числовой, с помощью одной или двух цифр) | 4 , где воскресенье является первым днем недели. |
ee | День недели (числовой, с помощью двух цифр) | 04
|
eee | День, сокращенное имя | Wed |
eeee | День, полное имя | Wednesday |
eeeee | День, использованный для своей выгоды сначала, обозначает буквами | W |
a | Дневной период (AM или PM) | PM |
h | Час, 12-часовое обозначение часов с помощью одной или двух цифр | 9
|
hh | Час, 12-часовое обозначение часов с помощью двух цифр | 09
|
H | Час, 24-часовое обозначение часов с помощью одной или двух цифр | 21
|
HH | Час, 24-часовое обозначение часов с помощью двух цифр | 21
|
m | Минута, с помощью одной или двух цифр | 41
|
mm | Минута, с помощью двух цифр | 41
|
s | Во-вторых, с помощью одной или двух цифр | 6
|
ss | Во-вторых, использование двух цифр | 06
|
S , SS ..., SSSSSSSSS | Доля секунды, с помощью количества цифр задана количеством экземпляров 'S' (до 9 цифр). | 'SSS' обрезает 6,12345 секунд до 6.123 . |
Примечание
Если вы читаете номер года 2D цифры и задаете формат как y
или yy
, затем год центра определяет век, которому принадлежит год.
Если вы читаете номер дня года и задаете формат, который содержит идентификаторы для обоих день года (D
) и Грегорианский год (y
то datetime
не может считать номер дня года правильно. Используйте год ISO (u
) вместо y
.
Используйте один или несколько u
символы вместо y
символы, чтобы представлять год при работе с числами года около нуля.
Значения datetime позже, чем CE 144 683 лет или перед 140743 BCE отображают только числа года, независимо от заданного Format
значение.
Используйте эти идентификаторы, чтобы задать формат отображения смещения часового пояса. Смещение часового пояса является количеством времени, что определенный datetime возмещен от UTC. Часовой пояс имеет правила для определения смещения часового пояса, и смещение может отличаться в разное время года. Включайте идентификатор смещения часового пояса в формат отображения для массива datetime, когда это необходимо, чтобы гарантировать, что компоненты времени отображены однозначно.
Обозначьте буквами идентификатор | Описание | Отображение |
---|---|---|
z | Сокращенное имя часового пояса возмещено. Если это значение не доступно, то смещение часового пояса использует короткий формат UTC, такой как UTC-4 . | EDT |
Z | ISO 8601 основной формат с часами, минутами и дополнительными полями секунд. | -0400
|
ZZZZ | Длинный формат UTC. | UTC-04:00 |
ZZZZZ | Расширенный формат ISO 8601 с часами, минутами и дополнительными полями секунд. Смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -04:00
|
x или X | ISO 8601 основной формат с полем часов и дополнительным мелким полем. Если вы задаете X , затем смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -04
|
xx или XX | ISO 8601 основной формат с часами и мелкими полями. Если вы задаете XX , затем смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -0400
|
xxx или XXX | Расширенный формат ISO 8601 с часами и мелкими полями. Если вы задаете XXX , затем смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -04:00
|
xxxx или XXXX | ISO 8601 основной формат с часами, минутами и дополнительными полями секунд. Если вы задаете XXXX , затем смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -0400
|
xxxxx или XXXXX | Расширенный формат ISO 8601 с часами, минутами и дополнительными полями секунд. Если вы задаете XXXXX , затем смещение времени нуля отображено как индикатор "Z" ISO 8601 UTC. | -04:00
|
TimeZone
TimeZone ''
(значение по умолчанию) | вектор символов | строковый скалярЧасовой пояс в виде вектора символов или строкового скаляра. Можно использовать это свойство изменить часовой пояс после создания datetime
массив.
Установить часовой пояс и вычислить смещения часового пояса, datetime
тип данных использует код и данные, обеспеченные Комитетом по цифровым адресам в интернете (IANA) в Базе данных Часового пояса IANA. Версия в настоящее время используется datetime
включает недавние обновления от IANA. (Чтобы использовать версию datetime
, возвратите второй выходной параметр timezones
функция.
Значение TimeZone
может быть:
''
, создать “незонный” datetime
массив, который не принадлежит определенному часовому поясу.
Имя области часового пояса от Базы данных Часового пояса IANA; например, 'America/Los_Angeles'
. Имя области часового пояса составляет текущие и исторические правила для стандарта и смещений дневного света от UTC, которые наблюдаются в географической области.
Вектор символов ISO 8601 формы +HH:mm
или -HH:mm
; например, '+01:00'
, задавать часовой пояс, который является фиксированным смещением от UTC.
'UTC'
, создать datetime
массив в универсальное время.
'UTCLeapSeconds'
, создать datetime
массив в универсальное время, которое считает в течение секунд прыжка. Для списка секунд прыжка, поддержанных datetime
тип данных, смотрите leapseconds
.
'local'
, создать datetime
массив в зоне системного времени. Когда вы запрашиваете TimeZone
свойство, значение IANA возвращено.
Эта таблица приводит некоторые общие названия областей часового пояса от Базы данных Часового пояса 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
Year
— Номер годаКоличество года каждого значения в datetime
массив в виде числового массива, который одного размера и форма с datetime
массив. Каждый год номер является целочисленным значением на основе календаря ISO. Годы в текущую эру положительны, и годы в предыдущую эру являются нулем или отрицательный. Например, количество года 1 BCE 0.
Если вы устанавливаете Year
свойство к году непрыжка для datetime
значение, которое происходит в день прыжка (29 февраля), затем Day
и Month
свойства изменяются до 1 марта.
Month
— Номер месяцаКоличество месяца каждого значения в datetime
массив в виде числового массива, который одного размера и форма с datetime
массив. Каждый месяц номер является целочисленным значением от 1 до 12. Если вы устанавливаете значение вне той области значений, то Year
свойство настраивает соответственно, и Month
свойство остается в области значений 1 - 12. Например, месяц 0 соответствует месяцу 12 из предыдущего года. Для исторических дат номер месяца основан на преждевременном Григорианском календаре.
Day
— Номер дня месяцаКоличество дня месяца каждого значения в datetime
массив в виде числового массива, который одного размера и форма с datetime
массив. Каждый день месяца номер является целочисленным значением от 1 до 28, 29, 30, или 31, в зависимости от месяца и года. Если вы устанавливаете значение вне той области значений, то Month
и Year
свойства настраивают соответственно, и Day
свойство остается в соответствующей области значений. Например, день 0 соответствует в последний день предыдущего месяца. Для исторических дат дневной номер основан на преждевременном Григорианском календаре.
Hour
— Номер часаКоличество часа каждого значения в datetime
массив в виде числового массива, который одного размера и форма с datetime
массив. Каждый час номер является целочисленным значением от 0 до 23. Если вы устанавливаете значение вне той области значений, то Day
месяц
, и Year
свойства настраивают соответственно, и Hour
свойство остается в соответствующей области значений. Например, час-1 соответствует часу 23 из предыдущего дня.
Эти условия применяются к массивам datetime с определенным часовым поясом, который следует за летним временем:
Когда вы задаете значение для Hour
свойство, которое создало бы несуществующий datetime в разрыве часа, когда летнее время начинается, значение Hour
свойство настраивает к следующему часу.
Когда вы задаете значение для Hour
свойство, которое создало бы неоднозначный datetime в перекрытии часа, когда летнее время заканчивается, datetime, настраивает к второму из этих двух раз (в стандартное время) с тем часом.
Minute
Номер минутыМелкое количество каждого значения в datetime
массив в виде числового массива, который одного размера и форма с datetime
массив. Каждую минуту номер является целочисленным значением от 0 до 59. Если вы задаете значение вне той области значений, то Hour
день
месяц
, и Year
свойства настраивают соответственно, и Minute
свойство остается в соответствующей области значений. Например, минута-1 соответствует минуте 59 из предыдущего часа.
Second
Номер секундыВторое количество каждого значения в datetime
массив в виде числового массива, который одного размера и форма с datetime
массив. Каждое второе значение обычно является значением с плавающей точкой в пределах от 0 к меньше чем 60. Если вы устанавливаете значение вне той области значений, то Minute
час
день
месяц
, и Year
свойства настраивают соответственно, и Second
свойство остается в соответствующей области значений. Например, вторые-1 соответствует вторым 59 из предыдущей минуты.
datetime
массив с TimeZone
значение 'UTCLeapSeconds'
имеет секунды в пределах от 0 к меньше чем 61. Значения от 60 до 61 представляют datetimes, которые происходят во время второго прыжка. (Поскольку список секунд прыжка поддержан datetime
тип данных, смотрите leapseconds
.)
SystemTimeZone
— Установка зоны системного времениЭто свойство доступно только для чтения.
Зона системного времени, устанавливающая в виде вектора символов или строкового скаляра. Система, куда MATLAB® запускается, определяет эту установку часового пояса.
Пример: America/New_York
Задайте текущую дату и время в локальной зоне системного времени.
t = datetime('now','TimeZone','local','Format','d-MMM-y HH:mm:ss Z')
t = datetime
17-Aug-2020 15:38:40 -0400
Задайте текущую дату и время в часовом поясе, представленном Сеулом, Корея
t = datetime('now','TimeZone','Asia/Seoul','Format','d-MMM-y HH:mm:ss Z')
t = datetime
18-Aug-2020 04:38:40 +0900
Создайте datetime
массив от массива ячеек из символьных векторов.
DateStrings = {'2014-05-26';'2014-08-03'}; t = datetime(DateStrings,'InputFormat','yyyy-MM-dd')
t = 2x1 datetime
26-May-2014
03-Aug-2014
Значения datetime в t
отображение с помощью формата по умолчанию, а не формата входных дат.
Начиная в R2016b, можно создать строковые массивы с string
функционируйте и преобразуйте их в значения datetime.
str = string({'2016-03-24','2016-04-19'})
str = 1x2 string
"2016-03-24" "2016-04-19"
Преобразуйте строки, задав формат ввода как yyyy-MM-dd
. Формат должен быть задан как вектор символов, даже при том, что str
массив строк.
t = datetime(str,'InputFormat','yyyy-MM-dd')
t = 1x2 datetime
24-Mar-2016 19-Apr-2016
Создайте datetime
значение из текста, который представляет дату и время точности миллисекунды. Преобразовывать текст в формате что datetime
функция не может проанализировать без большей информации, задать 'InputFormat'
аргумент пары "имя-значение".
d = '2018-06-25 11:23:37.712'; t = datetime(d,'InputFormat','yyyy-MM-dd HH:mm:ss.SSS')
t = datetime
25-Jun-2018 11:23:37
Преобразование действительно сохраняет доли секунды. Однако datetime
по умолчанию массивы не отображают доли секунды. Чтобы отобразить их, задайте любого
'Format'
пара "имя-значение" или Format
свойство.
t.Format = 'MMM dd, yyyy HH:mm:ss.SSS'
t = datetime
Jun 25, 2018 11:23:37.712
'InputFormat'
аргумент применяется только к преобразованиям из входного текста. Format
свойство задает отображение для любого datetime
массив.
Преобразуйте даты в формате ISO 8601 к значениям datetime.
Создайте массив ячеек из символьных векторов, содержащий даты в формате ISO 8601. В этом формате буква T используется в качестве разделителя, который разделяет дату и время. Каждый вектор символов включает смещение часового пояса. Буква Z не указывает ни на какое смещение от UTC.
DateStrings = {'2014-05-26T13:30-05:00';'2014-08-26T13:30-04:00';'2014-09-26T13:30Z'}
DateStrings = 3x1 cell
{'2014-05-26T13:30-05:00'}
{'2014-08-26T13:30-04:00'}
{'2014-09-26T13:30Z' }
Преобразуйте векторы символов в значения datetime. При определении формата ввода заключите букву T в одинарные кавычки, чтобы указать, что это - буквенный символ. Задайте часовой пояс выходного массива datetime с помощью TimeZone
аргумент пары "имя-значение".
t = datetime(DateStrings,'InputFormat','uuuu-MM-dd''T''HH:mmXXX','TimeZone','UTC')
t = 3x1 datetime
26-May-2014 18:30:00
26-Aug-2014 17:30:00
26-Sep-2014 13:30:00
Значения datetime в t
отобразитесь в формате по умолчанию.
Создайте массив ячеек из символьных векторов, содержащий даты на французском языке.
C = {'8 avril 2013','9 mai 2013';'10 juin 2014','11 juillet 2014'}
C = 2x2 cell
{'8 avril 2013'} {'9 mai 2013' }
{'10 juin 2014'} {'11 juillet 2014'}
Преобразуйте векторы символов в C
к значениям datetime. Если ваш компьютер установлен в локаль, которая использует английский язык, необходимо задать 'Locale'
аргумент пары "имя-значение", чтобы указать, что строки находятся на французском языке.
t = datetime(C,'InputFormat','d MMMM yyyy','Locale','fr_FR')
t = 2x2 datetime
08-Apr-2013 09-May-2013
10-Jun-2014 11-Jul-2014
Значения datetime в t
отобразитесь в формате по умолчанию, и на языке использование MATLAB в зависимости от вашей системной локали.
Создайте datetime
массив от отдельных массивов года, месяца и дневных значений.
Создайте демонстрационные числовые массивы значений года Y и дневных значений D. В этом случае значение месяца M является скаляром.
Y = [2014;2013;2012]; M = 01; D = [31;30;31];
Создайте datetime
массив.
t = datetime(Y,M,D)
t = 3x1 datetime
31-Jan-2014
30-Jan-2013
31-Jan-2012
Задайте пользовательский формат отображения для выхода, с помощью Format
аргумент пары "имя-значение".
t = datetime(Y,M,D,'Format','eeee, MMMM d, y')
t = 3x1 datetime
Friday, January 31, 2014
Wednesday, January 30, 2013
Tuesday, January 31, 2012
Создайте демонстрационный массив чисел даты Excel®, которые представляют много дней с января 0, 1900.
X = [39558, 39600; 39700, 39800]
X = 2×2
39558 39600
39700 39800
Преобразуйте значения в X
к значениям datetime.
t = datetime(X,'ConvertFrom','excel')
t = 2x2 datetime
20-Apr-2008 01-Jun-2008
09-Sep-2008 18-Dec-2008
Для списка datetime
функции, смотрите Даты и Время.
Для списка базовых функций MATLAB, которые принимают datetime
массивы как входные параметры, смотрите, что Базовые Функции Поддерживают Массивы дат и времен.
'InputFormat'
форматы месяца M
и MM
не распознавайте имена и MMM
не распознает полные имена месяцаПоведение изменяется в R2020a
Запуск в R2020a, когда вы задаете форматы месяца в 'InputFormat'
аргумент пары "имя-значение", M
и MM
форматы не распознают имена месяца. Кроме того, MMM
формат распознает только сокращенные имена, не полные имена месяца. В предыдущих релизах, все эти форматы распознанные и сокращенные и полные имена месяца.
Для получения дополнительной информации о форматах смотрите Format
свойство.
Указания и ограничения по применению:
Всегда задавайте входной формат datetime при создании высокого массива datetime для массива строк или векторов символов в массиве ячеек.
Если вы задаете 'Format'
как 'preserveinput'
, затем MATLAB может должен быть выполнить длинный массив, чтобы определить формат.
Для получения дополнительной информации см. Раздел "Высокие массивы".
Указания и ограничения по применению:
Начиная в R2020a, можно использовать datetime
массивы в коде MATLAB предназначаются для генерации кода. Для получения дополнительной информации смотрите Генерацию кода для Массивов datetime (MATLAB Coder) и Ограничения Массива datetime для Генерации кода (MATLAB Coder).
Указания и ограничения по применению:
Когда вы создаете datetime
массив из текста в DateStrings
, задайте формат ввода infmt
.
Для получения дополнительной информации смотрите функции MATLAB Запуска с Распределенными Массивами (Parallel Computing Toolbox).
calendarDuration
| cellstr
| char
| duration
| leapseconds
| NaT
| string
| timezones
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.