![]() ![]() |
Статический класс DateTimeSpan содержит функции, предназначенные для измерения промежутков времени между двумя значениями даты или времени, а также сложения и вычитания интервалов времени. В также предусмотрены функции определения разницы между между двумя датами. Поскольку значения интервалов времени представляют собой числа, для них допустимы обычные арифметические операции: умножение, деление, сложение, вычитание и т.д. Это статический класс. Приложения не могут создавать экземпляры данного класса.
Данная функция возвращает дату, представляющую собой результат прибавления указанного количества годов, месяцев и дней к начальной дате. Число месяцев может превышать 12, а число дней может превышать количество дней в месяце. Результат этой операции таков, как если бы были выполнены три независимые операции. Сначала прибавляются годы. Затем к получившейся дате прибавляются месяцы. Затем к результирующей дате прибавляются дни.
В результате прибавления месяцев может получиться недопустимая дата. Например, если прибавить один месяц к 31 января, может получиться 31 февраля. Данная функция корректирует дату в таких ситуациях: если результирующий год будет невисокосным, то в феврале будет 28 дней, и в результате будет получено 3 марта.
Для количества лет, месяцев и дней допустимы пустые и неопределенные значения. Они приравниваются к нулю.
Для количества лет, месяцев и дней допустимы отрицательные значения. В этом случае указанное значение вычитается из начальной даты.
DateTimeSpan.addDate( startDate, years, months, days )
Дата, получившаяся в результате прибавления указанного количества лет, месяцев и дней к начальной дате.
var startDate = date.parse( "2004-12-31" ); var endDate; endDate = DateTimeSpan( startDate, 1, 0, 0 ); // результат - 2005-12-31 endDate = DateTimeSpan( startDate, 0, 1, 0 ); // результат - 2005-1-31 endDate = DateTimeSpan( startDate, 0, 0, 1 ); // результат - 2005-1-1 endDate = DateTimeSpan( startDate, 1, 1, 1 ); // результат - 2005-3-4
Функция DateTimeSpan.addTime
Функция DateTimeSpan.subDate
Данная функция возвращает дату, представляющую собой результат прибавления указанного количества часов, минут и секунд к начальной дате. Число часов может превышать 24, а число минут и секунд может быть более 60. Результат этой операции таков, как если бы были выполнены три независимые операции: сначала прибавляется указанное количество часов. Затем к полученному значению прибавляются минуты. Затем к результирующей дате прибавляются секунды.
Для количества часов, минут и секунд допустимы пустые и неопределенные значения. Они приравниваются к нулю.
Для количества часов, минут и секунд допустимы и отрицательные значения. В этом случае указанное значение вычитается из начальной даты.
DateTimeSpan.addTime( startDate, hours, minutes, seconds )
Дата, получившаяся в результате прибавления указанного количества часов, минут и секунд к начальной дате.
Функция DateTimeSpan.addDate
Функция DateTimeSpan.subTime
Возвращает количество дней между двумя датами. Днем в данном случае считаются календарные сутки. Поэтому разница между 23:59:59 27.02 и 00:00:00 28.02 составляет 1 день, равно как разница между 00:00:00 27.02 и 23:59:59 28.02.
DateTimeSpan.days( startDate, endDate )
Возвращает количество дней между двумя датами.
Данная функция возвращает количество целых часов между двумя значениями времени. Целым часом называется промежуток времени от определенной минуты одного часа до этой же минуты другого часа. Например, разница между 1:23:00 и 2:23:00 составляет 1 целый час, а разница между 1:23:00 и 2:22:59 - 0 целых часов.
DateTimeSpan.hours( startDate, endDate )
Количество целых часов между двумя датами.
Данная функция возвращает количество целых минут между двумя значениями времени. Целой минутой называется промежуток времени от определенной секунды одной минуты до этой же секунды другой минуты. Например, разница между 1:23:00 и 1:24:00 составляет 1 целую минуту, а разница между 1:23:00 и 1:23:59 - 0 целых минут.
DateTimeSpan.minutes( startDate, endDate )
Количество целых минут между двумя датами.
Данная функция возвращает количество целых месяцев между двумя значениями времени. Целым месяцем называется промежуток времени от определенного дня одного месяца до того же дня следующего месяца. Например, разница между 28 февраля и 28 марта составляет 1 целый месяц, а между 28 февраля и 26 марта - 0 целых месяцев.
DateTimeSpan.months( startDate, endDate )
Возвращает количество целых месяцев между двумя датами.
Данная функция возвращает количество секунд между двумя значениями времени.
DateTimeSpan.seconds( startDate, endDate )
Количество целых минут между двумя датами.
Данная функция возвращает дату, представляющую собой результат вычитания указанного количества годов, месяцев и дней из начальной даты. Число месяцев может превышать 12, а число дней может превышать количество дней в месяце. Результат этой операции таков, как если бы были выполнены три независимые операции. Сначала отнимаются годы. Затем от полученной даты отнимаются месяцы. Затем от полученной даты отнимаются дни.
В результате вычитания месяцев может получиться недопустимая дата. Например, если вычесть 1 месяц из 30 марта, может получиться 30 февраля. Данная функция корректирует дату в таких случаях, заменяя ее последним днем соответствующего месяца. В данном примере, если год не високосный, в результате будет получена дата 28 февраля.
Для количества лет, месяцев и дней допустимы пустые и неопределенные значения. Они приравниваются к нулю.
Для количества лет, месяцев и дней допустимы отрицательные значения. В этом случае указанное значение прибавляется к начальной дате.
DateTimeSpan.subDate( startDate, years, months, days )
Дата, получившаяся в результате вычитания указанного количества лет, месяцев и дней из начальной даты.
Функция DateTimeSpan.addDate
Функция DateTimeSpan.subTime
Данная функция возвращает дату, представляющую собой результат вычитания указанного количества часов, минут и секунд из начальной даты. Число часов может превышать 24, а число минут и секунд может быть более 60. Результат этой операции таков, как если бы были выполнены три независимые операции. Сначала вычитаются часы. Затем из полученной даты вычитаются минуты. Затем из полученной даты вычитаются секунды.
Для количества часов, минут и секунд допустимы пустые и неопределенные значения. Они приравниваются к нулю.
Для количества часов, минут и секунд допустимы и отрицательные значения. В этом случае указанное значение прибавляется к начальной дате.
DateTimeSpan.subTime( startDate, hours, minutes, seconds )
Дата, получившаяся в результате вычитания указанного количества часов, минут и секунд из начальной даты.
Функция DateTimeSpan.addTime
Функция DateTimeSpan.subDate
Данная функция подсчитывает количество целых лет между двумя датами. Целым годом считается интервал времени от определенного месяца, дня и времени в одном году до того же месяца, дня и времени в следующем году. Ввиду того что некоторые годы високосные, целый год иногда состоит из 365 дней, а иногда из 366.
Если хотя бы один из аргументов не является датой, генерируется исключительная ситуация. Если хотя бы одному из аргументов присвоено пустое значение, результатом будет пустое значение.
DateTimeSpan.years( startDate, endDate )
Количество целых лет между двумя датами.
![]() ![]() |