Класс BirtDateTime предоставляет функции для определения интервала времени между двумя датами или значениями времени, для сложения и вычитания промежутков времени, а также для получения элементов значения даты. Поскольку значения интервалов времени представляют
собой числа, для них допустимы обычные арифметические операции: умножение, деление, сложение, вычитание и так далее. Это статический класс. Приложения не могут создавать экземпляры данного класса.
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа дней. Количество добавляемых дней может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Синтаксис
Параметры
date
Объект Date. Объект Date,
соответствующий начальной дате.
n
Числовой объект. Число дней, добавляемых к дате. Десятичные числа обрабатываются как целые (округление до ближайшего целого).
Возвращает
Объект Date. Дата, полученная в
результате добавления к начальной дате указанного числа дней.
Примеры
В следующих примерах к указанной дате добавляются дни:
В следующем примере к каждому значению даты в поле InvoiceDate добавляется 15 дней:
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа часов. Количество добавляемых часов может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Синтаксис
Параметры
date
Объект Дата, соответствующий начальной дате. Если для начальной даты не указано значение времени, то данная функция в качестве значения времени примет полночь (00:00:00).
n
Числовой объект. Количество часов, которое нужно прибавить к дате.
Возвращает
Объект Date. Дата, полученная в
результате добавления к начальной дате указанного числа часов.
Примеры
В следующих примерах к указанной дате и времени добавляются часы:
В следующем примере к каждому значению даты в поле StartTime добавляется 36 часов:
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа минут. Количество добавляемых минут может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Синтаксис
Параметры
date
Объект Дата, соответствующий начальной дате. Если для начальной даты не указано значение времени, то данная функция в качестве значения времени примет полночь (00:00:00).
n
Числовой объект. Количество минут, которое нужно прибавить к дате.
Возвращает
Объект Date. Дата, полученная в
результате добавления к начальной дате указанного числа минут.
Примеры
В следующих примерах к указанной дате и времени добавляются минуты:
В следующем примере к каждому значению даты в поле StartTime добавляется 15 минут:
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа месяцев. Количество добавляемых месяцев может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Данная функция всегда возвращает допустимое значение даты. При необходимости элемент даты, соответствующий дню в полученной дате, будет исправлен для отображения последнего дня полученного месяца в полученном году. Например, если требуется добавить 1 месяц к 31 янв 2008, то функция addMonth( ) возвратит 29 фев 2008 (2008 - високосный год), а не 31 фев 2008.
Синтаксис
Параметры
date
Объект Date. Объект Date, соответствующий начальной
дате.
n
Числовой объект. Число месяцев, добавляемых к дате. Десятичные числа обрабатываются как целые (округление).
Возвращает
Объект Date. Дата, полученная в результате добавления
к начальной дате указанного числа месяцев.
Примеры
В следующих примерах к указанной дате добавляются месяцы:
В следующем примере к каждому значению даты в поле InvoiceDate добавляется 10 месяцев:
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа кварталов. Квартал равнозначен трем месяцам. Например,
если добавить 2 квартала к 10 сентября 2008 года, то функция возвратит 10 марта
2009 года. Количество добавляемых кварталов может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Синтаксис
Параметры
date
Объект Дата, соответствующий начальной дате.
n
Числовой объект. Число кварталов, добавляемых к дате.
Возвращает
Объект Date. Дата, полученная в результате добавления к начальной дате указанного числа кварталов.
Примеры
В следующих примерах к указанной дате добавляются кварталы:
В следующем примере к каждому значению даты в поле ForecastClosing добавляется 2 квартала:
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа секунд. Количество добавляемых секунд может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Синтаксис
Параметры
date
Объект Дата, соответствующий начальной дате. Если для начальной даты не указано значение времени, то данная функция в качестве значения времени примет полночь (00:00:00).
n
Числовой объект. Число секунд, добавляемых к дате.
Возвращает
Объект Date. Результат добавления к начальной дате указанного числа секунд.
Примеры
В следующих примерах к указанной дате и времени добавляются секунды:
В следующем примере к каждому значению даты в поле StartTime добавляется 6000 секунд:
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа недель. Количество добавляемых недель может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Синтаксис
Параметры
date
Объект Дата, соответствующий начальной дате.
n
Числовой объект. Число недель, добавляемых к дате.
Возвращает
Объект Date. Дата, полученная в результате добавления
к начальной дате указанного числа недель.
Примеры
В следующих примерах к указанной дате добавляются недели:
В следующем примере к каждому значению даты в поле InvoiceDate добавляется 2 недели:
Эта функция возвращает новую дату, которая является результатом добавления к дате указанного числа лет. Количество добавляемых лет может быть отрицательным. В этом случае указанное значение
вычитается из указанной даты.
Синтаксис
Параметры
date
Объект Дата, соответствующий начальной дате.
n
Числовой объект. Число лет, добавляемых к дате. Десятичные числа обрабатываются как целые (округление).
Возвращает
Дата, полученная в результате добавления к начальной дате указанного числа лет.
Примеры
В следующих примерах к указанной дате добавляется некоторое число лет:
В следующем примере к каждому значению даты в поле HireDate добавляется 5 лет:
Эта функция возвращает число в диапазоне от 1 до 31, представляющее день месяца для указанной даты. Например, если значение даты равно 2009-01-19, то функция возвращает 19.
Синтаксис
Параметр
date
Объект Date. Объект Дата, из
которого требуется получить день месяца.
Возвращает
Целое число, представляющее день месяца для указанной
даты.
Примеры
В следующем примере возвращается день месяца для каждого значения в поле ShipDate:
В следующем примере возвращается день месяца для текущей даты:
Эта функция возвращает число дней между двумя датами. День вычисляется путем вычитания значения дня первой даты из значения дня второй даты. Например, если значение первой даты равно 2008-12-30 23:59:59, а второй - 2008-12-31 00:00:00, то функция возвращает 1 день, несмотря на то, что между этими двумя датами всего одна секунда.
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Число дней между двумя датами.
Примеры
В следующем примере возвращается число дней между указанными датами:
В следующем примере возвращается число дней между текущей датой и окончанием 2009 года:
В следующем примере возвращается число дней между значениями в полях InvoiceDate и PaymentDate:
Эта функция возвращает количество часов между двумя датами. Часы вычисляются путем вычитания значения часов первой даты из значения часов второй даты. Например, если значение первой даты равно 2009-01-31 1:30:00, а второй - 2009-01-31 2:00:00, то функция возвращает 1 час, несмотря на то, что между этими двумя датами всего 30 минут. Если для даты не указано значение времени, то данная функция в качестве значения времени примет полночь (00:00:00).
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Количество часов между двумя датами.
Примеры
В следующем примере возвращается количество часов между указанными датами:
В следующем примере возвращается количество часов между текущей датой и временем и окончанием 2009 года:
В следующем примере возвращается количество часов между значениями в полях StartTime и FinishTime:
Эта функция возвращает количество минут между двумя датами. Минуты вычисляются путем вычитания значения минут первой даты из значения минут второй даты. Например, если значение первой даты равно 2009-01-31 1:30:59, а второй - 2009-01-31 1:31:00, то функция возвращает 1 минуту, несмотря на то, что между этими двумя датами всего одна секунда. Если для даты не указано значение времени, то данная функция в качестве значения времени примет полночь (00:00:00).
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Количество минут между двумя датами.
Примеры
В следующем примере возвращается количество минут между указанными датами:
В следующем примере возвращается количество минут между текущей датой и временем и началом 2010 года:
В следующем примере возвращается количество минут между значениями в полях StartTime и FinishTime:
Эта функция возвращает число месяцев между двумя датами. Месяц вычисляется путем вычитания значения месяца первой даты из значения месяца второй даты. Например, если значение первой даты равно 2009-01-31, а второй - 2009-02-01, то функция возвращает 1 месяц, несмотря на то, что между этими двумя датами всего один день.
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Число месяцев между двумя датами.
Примеры
В следующем примере возвращается число месяцев между указанными датами:
В следующем примере возвращается число месяцев между текущей датой и началом 2010 года:
В следующем примере возвращается число месяцев между значениями в полях ProjectStart и ProjectComplete:
Эта функция возвращает число кварталов между двумя датами. Квартал вычисляется путем вычитания значения месяца первой даты из значения месяца второй даты. Разница в 3 месяца составляет 1 квартал. Например, если значение первой даты равно 2009-01-31, а второй - 2009-07-01, то функция возвращает 2. Если значение первой даты равно 2009-01-01, а второй - 2009-09-30, функция также возвращает 2.
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Число кварталов между двумя датами.
Примеры
В следующем примере возвращается число кварталов между указанными датами:
В следующем примере возвращается число кварталов между текущей датой и началом 2010 года:
В следующем примере возвращается число кварталов между значениями в полях ProjectStart и ProjectComplete:
Эта функция возвращает количество секунд между двумя датами. Если для даты не указано значение времени, то данная функция в качестве значения времени примет полночь (00:00:00).
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Количество секунд между двумя датами.
Примеры
В следующем примере возвращается количество секунд между указанными датами:
В следующем примере возвращается количество секунд между текущей датой и временем и началом 2010 года:
В следующем примере возвращается количество секунд между значениями в полях StartTime и FinishTime:
Эта функция возвращает число недель между двумя датами. Неделя
вычисляется путем вычитания номера недели первой даты из
номера недели второй даты. Например, если значение первой даты равно 2009-01-02 (первая неделя года), а второй - 2009-01-05 (вторая неделя года), то функция возвращает 1 неделю, несмотря на то, что между этими двумя датами всего три дня.
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Число недель между двумя датами.
Примеры
В следующем примере возвращается число недель между указанными датами:
В следующем примере возвращается число недель между текущей датой и началом 2010 года:
В следующем примере возвращается число недель между значениями в полях ProjectStart и ProjectComplete:
Эта функция возвращает число лет между двумя датами. Год вычисляется путем вычитания значения года первой даты из значения года второй даты. Например, если значение первой даты равно 2009-01-01, а второй - 2009-12-31, то функция возвращает 0. Если значение первой даты равно 2008-11-15, а второй - 2009-01-15, функция возвращает 1.
Синтаксис
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Число лет между двумя датами.
Примеры
В следующем примере возвращается число лет между указанными датами:
В следующем примере возвращается число лет между всеми значениями в поле HireDate и текущей датой:
Эта функция возвращает число лет между двумя датами. Год вычисляется путем вычитания значения года первой даты из значения года второй даты. Например, если значение первой даты равно 2009-01-01, а второй - 2009-12-31, то функция возвращает 0. Если значение первой даты равно 2008-11-15, а второй - 2009-01-15, функция возвращает 1.
Syntax
Параметры
date1
Объект Дата, соответствующий началу интервала.
date2
Объект Дата, соответствующий окончанию интервала.
Возвращает
Integer. Число лет между двумя датами.
Примеры
В следующем примере возвращается число лет между указанными датами:
В следующем примере возвращается число лет между всеми значениями в поле HireDate и текущей датой:
Эта функция возвращает дату первого дня месяца, на который приходится входная дата.
Syntax
Параметры
date
Объект Дата, из которого требуется получить месяц.
Возвращает
Объект Date. Первый день месяца для указанной даты.
Примеры
В следующем примере показаны значения месяца, возвращаемые для указанной даты:
Эта функция возвращает дату первого дня
квартала, на который приходится входная дата.
Syntax
Параметры
date
Объект Дата, из которого требуется получить квартал.
Возвращает
Объект Date. Первый день квартала для указанной даты.
Примеры
В следующем примере показаны значения
квартала, возвращаемые для указанной даты:
Эта функция возвращает дату первого дня
недели, на которую приходится входная дата (всегда Воскресенье).
Syntax
Параметры
date
Объект Дата, из которого требуется получить
неделю.
Возвращает
Объект Date. Первый день недели для указанной даты.
Примеры
В следующем примере показаны значения
недели, возвращаемые для указанной даты:
Эта функция возвращает дату первого дня
года, на который приходится входная дата.
Syntax
Параметры
date
Объект Дата, из которого требуется получить
год.
Возвращает
Объект Date. Первый день года для указанной даты.
Примеры
В следующем примере показаны значения
года,
возвращаемые для указанной даты:
Эта функция возвращает месяц указанной даты. В зависимости от заданного параметра option функция возвращает месяц в виде числа, полного названия месяца или сокращенного названия месяца. Именование месяца определяется локалью.
Syntax
Параметры
date
Объект Дата, из которого требуется получить месяц.
option
Integer. Необязательный атрибут. Число, представляющее формат возвращаемого месяца. Можно использовать одно из следующих значений:
Если этот параметр не задан, функция возвращает месяц в виде номера.
Возвращает
String. Месяц в указанной дате.
Примеры
В следующем примере показаны значения месяца, возвращаемые для указанной даты:
В следующем примере возвращается месяц в текущей дате:
Эта функция возвращает текущую дату и время, например: 2 фев 2009 14:05.
Синтаксис
Возвращает
Объект Date. Текущая дата и время.
Пример
В следующем примере возвращается количество часов между текущей датой и временем и Рождеством:
Эта функция возвращает число в диапазоне от 1 до 4, представляющее квартал, к которому относится указанная дата. Первый квартал начинается с 1 января.
Синтаксис
Параметр
date
Объект Дата, из которого требуется получить номер квартала.
Возвращает
Integer. Номер квартала для указанной даты.
Примеры
В следующем примере показаны номера кварталов, возвращаемые для определенных дат:
В следующем примере возвращается номер квартала для каждого значения в поле CloseDate:
В следующем примере возвращается номер квартала для текущей даты:
Эта функция возвращает текущую дату со значением времени, соответствующим полуночи, например 2 февраля 2009 г., 00:00.
Синтаксис
Возвращает
Объект Date. Текущая дата со значением времени, соответствующим полночи.
Примеры
В следующем примере возвращается число дней между текущей датой и Рождеством:
В следующем примере возвращается число лет между всеми значениями в поле даты HireDate и текущей датой.
Эта функция возвращает число в диапазоне от 1 до 52, представляющее номер недели для указанной даты.
Синтаксис
Параметр
date
Объект Дата, из которого требуется получить номер недели.
Возвращает
Integer. Номер недели для указанной даты.
Примеры
В следующем примере показаны номера недель, возвращаемые для определенных дат:
В следующем примере возвращается номер недели для каждого значения в поле CloseDate:
В следующем примере возвращается номер недели для текущей даты:
Эта функция возвращает день недели для указанной даты. В зависимости от заданного параметра option функция возвращает день недели в виде числа, полного названия недели или сокращенного названия недели. Именование дней недели определяется локалью.
Синтаксис
Параметры
date
Объект Дата, из которого требуется получить день недели.
option
Integer. Необязательный атрибут. Число, представляющее формат возвращаемого значения. Можно использовать одно из следующих значений:
Если этот параметр не задан, функция использует значение 1.
Возвращает
String. День недели для указанной даты.
Примеры
В следующем примере показаны значения дня недели, возвращаемые для указанной даты:
В следующем примере возвращается день недели для текущей даты:
Эта функция возвращает значение года указанной даты в виде четырехзначного числа. Например, если значение даты равно 2009-01-19, то функция возвращает 2009.
Синтаксис
Параметр
date
Объект Дата, из которого требуется получить год.
Возвращает
Integer. Значение года указанной даты в виде четырехзначного числа.
Примеры
В следующем примере возвращается год для каждого значения в поле HireDate:
В следующем примере возвращается год для текущей даты: