Предыдущий разделСледующий раздел


Класс DateTimeSpan

Статический класс DateTimeSpan содержит функции, предназначенные для измерения промежутков времени между двумя значениями даты или времени, а также сложения и вычитания интервалов времени. В также предусмотрены функции определения разницы между между двумя датами. Поскольку значения интервалов времени представляют собой числа, для них допустимы обычные арифметические операции: умножение, деление, сложение, вычитание и т.д. Это статический класс. Приложения не могут создавать экземпляры данного класса.

DateTimeSpan.addDate

Данная функция возвращает дату, представляющую собой результат прибавления указанного количества годов, месяцев и дней к начальной дате. Число месяцев может превышать 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

DateTimeSpan.addTime

Данная функция возвращает дату, представляющую собой результат прибавления указанного количества часов, минут и секунд к начальной дате. Число часов может превышать 24, а число минут и секунд может быть более 60. Результат этой операции таков, как если бы были выполнены три независимые операции: сначала прибавляется указанное количество часов. Затем к полученному значению прибавляются минуты. Затем к результирующей дате прибавляются секунды.

Для количества часов, минут и секунд допустимы пустые и неопределенные значения. Они приравниваются к нулю.

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

Синтаксис

DateTimeSpan.addTime( startDate, hours, minutes, seconds )

Аргументы

Возвращаемое значение

Дата, получившаяся в результате прибавления указанного количества часов, минут и секунд к начальной дате.

См. также

Функция DateTimeSpan.addDate

Функция DateTimeSpan.subTime

DateTimeSpan.days

Возвращает количество дней между двумя датами. Днем в данном случае считаются календарные сутки. Поэтому разница между 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 )

Аргументы

Возвращаемое значение

Возвращает количество дней между двумя датами.

DateTimeSpan.hours

Данная функция возвращает количество целых часов между двумя значениями времени. Целым часом называется промежуток времени от определенной минуты одного часа до этой же минуты другого часа. Например, разница между 1:23:00 и 2:23:00 составляет 1 целый час, а разница между 1:23:00 и 2:22:59 - 0 целых часов.

Синтаксис

DateTimeSpan.hours( startDate, endDate )

Аргументы

Возвращаемое значение

Количество целых часов между двумя датами.

DateTimeSpan.minutes

Данная функция возвращает количество целых минут между двумя значениями времени. Целой минутой называется промежуток времени от определенной секунды одной минуты до этой же секунды другой минуты. Например, разница между 1:23:00 и 1:24:00 составляет 1 целую минуту, а разница между 1:23:00 и 1:23:59 - 0 целых минут.

Синтаксис

DateTimeSpan.minutes( startDate, endDate )

Аргументы

Возвращаемое значение

Количество целых минут между двумя датами.

DateTimeSpan.months

Данная функция возвращает количество целых месяцев между двумя значениями времени. Целым месяцем называется промежуток времени от определенного дня одного месяца до того же дня следующего месяца. Например, разница между 28 февраля и 28 марта составляет 1 целый месяц, а между 28 февраля и 26 марта - 0 целых месяцев.

Синтаксис

DateTimeSpan.months( startDate, endDate )

Аргументы

Возвращаемое значение

Возвращает количество целых месяцев между двумя датами.

DateTimeSpan.seconds

Данная функция возвращает количество секунд между двумя значениями времени.

Синтаксис

DateTimeSpan.seconds( startDate, endDate )

Аргументы

Возвращаемое значение

Количество целых минут между двумя датами.

DateTimeSpan.subDate

Данная функция возвращает дату, представляющую собой результат вычитания указанного количества годов, месяцев и дней из начальной даты. Число месяцев может превышать 12, а число дней может превышать количество дней в месяце. Результат этой операции таков, как если бы были выполнены три независимые операции. Сначала отнимаются годы. Затем от полученной даты отнимаются месяцы. Затем от полученной даты отнимаются дни.

В результате вычитания месяцев может получиться недопустимая дата. Например, если вычесть 1 месяц из 30 марта, может получиться 30 февраля. Данная функция корректирует дату в таких случаях, заменяя ее последним днем соответствующего месяца. В данном примере, если год не високосный, в результате будет получена дата 28 февраля.

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

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

Синтаксис

DateTimeSpan.subDate( startDate, years, months, days )

Аргументы

Возвращаемое значение

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

См. также

Функция DateTimeSpan.addDate

Функция DateTimeSpan.subTime

DateTimeSpan.subTime

Данная функция возвращает дату, представляющую собой результат вычитания указанного количества часов, минут и секунд из начальной даты. Число часов может превышать 24, а число минут и секунд может быть более 60. Результат этой операции таков, как если бы были выполнены три независимые операции. Сначала вычитаются часы. Затем из полученной даты вычитаются минуты. Затем из полученной даты вычитаются секунды.

Для количества часов, минут и секунд допустимы пустые и неопределенные значения. Они приравниваются к нулю.

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

Синтаксис

DateTimeSpan.subTime( startDate, hours, minutes, seconds )

Аргументы

Возвращаемое значение

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

См. также

Функция DateTimeSpan.addTime

Функция DateTimeSpan.subDate

DateTimeSpan.years

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

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

Синтаксис

DateTimeSpan.years( startDate, endDate )

Аргументы

Возвращаемое значение

Количество целых лет между двумя датами.


(c) Copyright Actuate Corporation 2006

Предыдущий разделСледующий раздел