duration

Отрезки времени в модулях фиксированной длины

Описание

Значения в массиве длительности представляют прошедшие времена в модулях фиксированной длины, таких как часы, минуты и секунды. Также можно создать прошедшие времена в терминах фиксированной длины (24-часовые) дни и фиксированная длина (365.2425-дневные) годы.

Работа с массивами длительности, когда вы работали бы с числовыми массивами. Можно добавить, вычесть, отсортировать, сравнить, конкатенировать и построить массивы длительности. Используйте массивы длительности, чтобы упростить вычисления на массивах datetime, которые включают единицы измерения времени, такие как часы и минуты.

Создание

Можно создать массивы длительности, которые имеют модули требуемого времени с помощью years, days, hours, minutes, seconds, и milliseconds функции. Например, чтобы создать массив, который имеет прошедшие времена 1, 2, и 3 часа, использование hours функция.

D = hours(1:3)
D = 

  1×3 duration array

   1 hr   2 hr   3 hr

Также можно создать массив длительности с помощью duration функция, описанная ниже.

Описание

пример

D = duration(H,MI,S) создает массив длительности из числовых массивов, содержащих номер часов, минут и секунд, заданных H, MI, и S.

D = duration(H,MI,S,MS) добавляют миллисекунды к массиву длительности, заданному MS.

пример

D = duration(X) создает вектор-столбец длительности из числовой матрицы.

пример

D = duration(TimeStrings) преобразует текст, который представляет прошедшие времена в массив длительности. TimeStrings должен представлять времена с помощью любого 'hh:mm:ss' или 'dd:hh:mm:ss' формат.

пример

D = duration(TimeStrings,'InputFormat',infmt) преобразует текст с помощью формата, заданного infmt.

пример

D = duration(___,'Format',displayFormat) дополнительно задает формат отображения для D. Это свойство изменяет отображение D, но не его значения. Можно использовать этот синтаксис с любым из аргументов от предыдущих синтаксисов.

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

развернуть все

Час, минута и вторые массивы в виде числовых массивов. Любой из этих массивов может быть скаляром. Все массивы, которые не являются скалярами, должны быть одного размера.

Пример: duration(12,45,7) возвращает длительность 12 часов, 45 минут и 7 секунд.

Массив миллисекунды в виде числового массива. MS или должен быть скаляр или тот же размер как H, MI, и S входные параметры.

Пример: duration(12,45,30,35) возвращает длительность 12 часов, 45 минут, 30 секунд и 35 миллисекунд.

Введите матрицу в виде числовой матрицы. X должен иметь три столбца, содержа числа часов, минут и секунд, соответственно.

Пример: duration([12 30 16]) возвращает длительность 12 часов, 30 минут и 16 секунд.

Текст, представляющий прошедшие времена в виде вектора символов, массива ячеек из символьных векторов или массива строк. duration функционируйте пытается совпадать с форматом TimeStrings любому 'hh:mm:ss' или 'dd:hh:mm:ss' форматы, где dd, hh, mm, и ss представляйте дни, часы, минуты и секунды. Последнее поле может включать цифры справа от десятичной метки, представляющей доли секунды.

Если вы знаете формат, задаете 'InputFormat' и его соответствующий infmt значение.

Пример: duration('12:30:16') возвращает длительность 12 часов, 30 минут и 16 секунд.

Пример: duration('00:05:23.86') возвращает длительность 5 минут и 23,86 секунд.

Пример: duration({'01:34:21';'23:16:54'}) возвращает вектор-столбец, содержащий две длительности.

Формат входного текста в виде вектора символов или строкового скаляра.

Задайте infmt как любой из следующих форматов, где dd, hh, mm, и ss представляйте дни, часы, минуты и секунды:

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • Любой из первых трех форматов, максимум с девятью S символы, чтобы указать на цифры доли секунды, такие как 'hh:mm:ss.SSSS'

Свойства

развернуть все

Формат отображения в виде вектора символов или строкового скаляра. Формат может задать любого один номер с единицами измерения времени (такими как 'y' для номера лет) или цифровой таймер (таких как 'hh:mm:ss' для чисел часов, минут и секунд).

Для чисел с единицами измерения времени задайте одно из следующего:

  • 'y' — Годы фиксированной длины, где один год равняется 365,2425 дням

  • 'd' — Дни фиксированной длины, где однажды равняется 24 часам

  • 'h' часы

  • 'm' минуты

  • 's' секунды

Для цифровых форматов таймера задайте одно из следующего:

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

  • Любой из первых трех форматов, максимум с девятью S символы, чтобы указать на цифры доли секунды, такие как 'hh:mm:ss.SSSS'

Пример: D.Format = 'm' отображения каждое значение в D как много минут.

Примеры

свернуть все

Задайте значение datetime.

D = datetime('today')
D = datetime
   23-Mar-2021

Создайте массив datetime, в котором каждое значение имеет ту же дату, но различные компоненты времени. Один удобный способ создать такой массив состоит в том, чтобы добавить массив длительности в D.

Во-первых, создайте массив часов с помощью hours функция. Каждым элементом составляют два часа дольше, чем предыдущий элемент.

H = hours(0:2:6)
H = 1x4 duration
   0 hr   2 hr   4 hr   6 hr

Затем добавьте D и H.

T = D + H
T = 1x4 datetime
Columns 1 through 3

   23-Mar-2021 00:00:00   23-Mar-2021 02:00:00   23-Mar-2021 04:00:00

Column 4

   23-Mar-2021 06:00:00

Используйте массивы длительности для арифметических операций с массивами datetime и фиксированными длинами времени.

Создайте массив длительности, задав часы, минуты и секунды как входные параметры. Поскольку второй аргумент является массивом, выходом D массив, который имеет тот же размер.

D = duration(1,30:33,0)
D = 1x4 duration
   01:30:00   01:31:00   01:32:00   01:33:00

Создайте числовую матрицу с тремя столбцами. Столбцы представляют часы, минуты и секунды соответственно.

X = [12 17 54;9 32 3]
X = 2×3

    12    17    54
     9    32     3

Преобразуйте матрицу в массив длительности.

D = duration(X)
D = 2x1 duration
   12:17:54
   09:32:03

Преобразуйте вектор символов, представляющий время как часы, минуты и секунды.

T = '6:34:12';
D = duration(T)
D = duration
   06:34:12

Преобразуйте массив ячеек из символьных векторов.

T = {'12:54:37','8:03:12'};
D = duration(T)
D = 1x2 duration
   12:54:37   08:03:12

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

T = '1:00:54:21';
D = duration(T)
D = duration
   24:54:21

Задайте формат текста, представляющего прошедшие времена, и затем преобразуйте их в массивы длительности.

Преобразуйте вектор символов. Формат ввода представляет минуты и секунды. Выходным аргументом является значение длительности, формат которого представляет часы, минуты и секунды.

T = '78:34';
infmt = 'mm:ss';
D = duration(T,'InputFormat',infmt)
D = duration
   01:18:34

Создайте массив ячеек из символьных векторов, формат которого представляет минуты, секунды и части секунды к трем десятичным разрядам.

infmt = 'mm:ss.SSS';
T = {'1:34.862' '67:07.218'}
T = 1x2 cell
    {'1:34.862'}    {'67:07.218'}

Преобразуйте T к массиву длительности. Укажите, что формат массива длительности представляет часы, минуты, секунды и части секунды.

outfmt = 'hh:mm:ss.SSS';
D = duration(T,'InputFormat',infmt,'Format',outfmt)
D = 1x2 duration
   00:01:34.862   01:07:07.218

Создайте массив длительности из матрицы. Эти три столбца задают часы, минуты и секунды, соответственно. Отобразите значения в цифровые минуты показа формата таймера и секунды.

X = [2 3 16;1 5 59;1 45 0]
X = 3×3

     2     3    16
     1     5    59
     1    45     0

D = duration(X,'Format','mm:ss')
D = 3x1 duration
   123:16
    65:59
   105:00

Советы

  • Для получения дополнительной информации о функциях, которые принимают или возвращают массивы длительности, смотрите Даты и Время.

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

Введенный в R2014b