Перейти к содержанию

Дата и время: различия между версиями

Материал из Химсофт Вики
← Предыдущая правка
Sidminik (обсуждение | вклад)
Бюрократы, Администраторы интерфейса, Скрывающие, Администраторы
4171 правка
 
(не показано 16 промежуточных версий этого же участника)
Строка 1: Строка 1:
Инструменты VB.NET для работы с датой и временем позволяют:
==Установка конкретной даты==
*выполнять арифметические операции и извлекать компоненты периодов;  
Для установки конкретной даты можно использовать:
*привести отображение даты к необходимому системному или пользовательскому виду за счет стандартных шаблонов форматирования.
*конструкторы структуры <code>DateTime</code>;
:<syntaxhighlight lang="csharp">
new DateTime(год, месяц, день, часы, минуты, секунды);
</syntaxhighlight>
*функцию <code>ToDateTime</code> (подробнее в разделе [[Конвертирование]]);
*функцию <code>DateSerial</code> (рассматривается ниже).


==Функции по работе с датой и временем==
==Информация о времени==
{|class="wikitable" style="margin:auto; background-color: #fff;"  
*при использовании функций для преобразования даты из данного раздела по умолчанию сохраняется и информация о времени;
*для удаления времени из даты можно воспользоваться функциями <code>Format</code> или <code>FormatDateTime</code> (более подробная информация об этих функциях представлена в разделе [[Форматирование]]).
 
<div style="background-color: #e7f3ff; border-left: 5px solid #2196f3; padding: 15px; margin: 10px 0;">
'''Примечание'''
 
В качестве примера использования поля из базы данных в функциях будет использоваться условное поле <code>[Employees.BirthDate]</code>:
<syntaxhighlight lang="text">
[Employees.BirthDate] = 27.01.1986
</syntaxhighlight>
</div>
 
== AddDays ==
{|class="wikitable" style="background-color: #fff;"  
|-
|-
!Имя функции
! Функция !! Параметры !! Возвращаемое значение
!Описание
!Пример
|-
|-
|DateAdd
 
|Возвращает значение даты и времени, которое является результатом прибавления интервала к полю даты\времени указанной единицы измерения.
| <code>AddDays</code> || <code>DateTime date, double value</code> || <code>DateTime</code>
|<code>DateAdd(<DateInterval>,<Number>,<DateTime>)</code><br><code>=DateAdd("d", 5, Fields!SaleDate.Value);</code><br><code>=DateAdd(DateInterval.Day, 5, Fields!SaleDate.Value)</code>
|}
 
Добавляет к дате <code>date</code> количество дней <code>value</code> и возвращает новую дату.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
AddDays(new DateTime(2024,4,2), 2) = 04.04.2024 0:00:00
AddDays(ToDateTime("2.4.2024"), 2) = 04.04.2024 0:00:00
AddDays([Employees.BirthDate], 2) = 29.01.1986 0:00:00
</syntaxhighlight>
 
== AddHours ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|DateDiff
! Функция !! Параметры !! Возвращаемое значение
|Возвращает разницу между начальной датой и временем и конечной датой и временем заданной единицы измерения.
|<code>DateDiff(<DateInterval>,<DateTime1>,<DateTime2>[,<DayOfWeek>[,WeekOfYear]]))</code><br><code>=DateDiff("yyyy"),Fields!SaleDate.Value,"1/1/2015");</code><br><code>=DateDiff(DateInterval.Year,Fields!SaleDate.Value,"1/1/2015")</code>
|-
|-
|DatePart
 
|Возвращает дату в числовом представлении (номер даты)
| <code>AddHours</code> || <code>DateTime date, double value</code> || <code>DateTime</code>
|<code>DatePart(<DateInterval>,<DateTime1>[,<FirstDayOfWeek>[,FirstWeekOfYear]]))</code><br><code>=DatePart("m", Fields!SaleDate.Value)</code>
|}
 
Добавляет к дате <code>date</code> количество часов <code>value</code> и возвращает новую дату.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
AddHours(new DateTime(2024,4,2,5,30,5), 1) = 02.04.2024 6:30:05
AddHours(ToDateTime("2.4.2024 5:30:05"), 1) = 02.04.2024 6:30:05
AddHours([Employees.BirthDate], 1) = 27.01.1986 1:00:00
</syntaxhighlight>
 
== AddMinutes ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|DateSerial
! Функция !! Параметры !! Возвращаемое значение
|Возвращает дату, сложенную из года+месяца+дня
|<code>DateSerial(<Year Number>,<Month Number>,<Day Number>)</code><br><code>=DateSerial(DatePart("yyyy", Fields!SaleDate.Value)-10, DatePart("m", Fields!SaleDate.Value)+5, DatePart("d", Fields!SaleDate.Value)-1)</code>
|-
|-
|DateString
 
|Возвращает дату в строковом представлении, из настроек ОС
| <code>AddMinutes</code> || <code>DateTime date, double value</code> || <code>DateTime</code>
|<code>DateString()</code><br><code>=DateString()</code>
|}
 
Добавляет к дате <code>date</code> количество минут <code>value</code> и возвращает новую дату.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
AddMinutes(new DateTime(2024,4,2,5,30,5), 10) = 02.04.2024 5:40:05
AddMinutes(ToDateTime("2.4.2024 5:30:05"), 10) = 02.04.2024 5:40:05
AddMinutes([Employees.BirthDate], 10) = 27.01.1986 0:10:00
</syntaxhighlight>
 
== AddMonths ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|DateValue
! Функция !! Параметры !! Возвращаемое значение
|Возвращает дату, полученную из строки
|<code>DateValue(<StringDate>)</code><br><code>=DateValue("December 12, 2015")</code>
|-
|-
|Now
 
|Возвращает текущую дату и время
| <code>AddMonths</code> || <code>DateTime date, int value</code> || <code>DateTime</code>
|<code>Now()</code><br><code>=Now()</code>
|}
 
Добавляет к дате <code>date</code> количество месяцев <code>value</code> и возвращает новую дату.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
AddMonths(new DateTime(2024,4,2,5,30,5), 2) = 02.06.2024 5:30:05
AddMonths(ToDateTime("2.4.2024 5:30:05"), 2) = 02.06.2024 5:30:05
AddMonths([Employees.BirthDate], 2) = 27.03.1986 0:00:00
</syntaxhighlight>
 
== AddSeconds ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|Today
! Функция !! Параметры !! Возвращаемое значение
|Возвращает текущую системную дату
|<code>Today()</code><br><code>=Today()</code>
|-
|-
|Day
 
|Возвращает текущий день месяца (0..31)
| <code>AddSeconds</code> || <code>DateTime date, double value</code> || <code>DateTime</code>
|<code>Day(<DateTime>)</code><br><code>=Day(Fields!SaleDate.Value)</code>
|}
 
Добавляет к дате <code>date</code> количество секунд <code>value</code> и возвращает новую дату.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
AddSeconds(new DateTime(2024,4,2,5,30,5), 10) = 02.04.2024 5:30:15
AddSeconds(ToDateTime("2.4.2024 5:30:05"), 10) = 02.04.2024 5:30:15
AddSeconds([Employees.BirthDate], 10) = 27.01.1986 0:00:10
</syntaxhighlight>
 
== AddYears ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|Hour
! Функция !! Параметры !! Возвращаемое значение
|Возвращает текущий час дня (0..24)
|<code>Hour(<DateTime>)</code><br><code>=Hour(Fields!SaleDate.Value)</code>
|-
|-
|Minute
 
|Возвращает текущую минуту часа (0..59)
| <code>AddYears</code> || <code>DateTime date, int value</code> || <code>DateTime</code>
|<code>Minute(<DateTime>)</code><br><code>=Minute(Fields!SaleDate.Value)</code>
|}
 
Добавляет к дате <code>date</code> количество лет <code>value</code> и возвращает новую дату.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
AddYears(new DateTime(2024,4,2,5,30,5), 3) = 02.04.2027 5:30:05
AddYears(ToDateTime("2.4.2024 5:30:05"), 3) = 02.04.2027 5:30:05
AddYears([Employees.BirthDate], 3) = 27.01.1989 0:00:00
</syntaxhighlight>
 
== DateDiff ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|Month
! Функция !! Параметры !! Возвращаемое значение
|Возвращает текущий номер месяца (0..12)
|<code>Month(<DateTime>)</code><br><code>=Month(Fields!SaleDate.Value)</code>
|-
|-
|MonthName
 
|Возвращает имя месяца по номеру или аббревиатуре
| <code>DateDiff</code> || <code>DateTime date1, DateTime date2</code> || <code>TimeSpan</code>
|<code>MonthName(<Month Number>[,<Abbreviate>])</code><br><code>=MonthName(Fields!SaleDate.Value)</code>
|}
 
Возвращает интервал — количество дней, часов, минут, секунд между двумя датами.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
DateDiff(new DateTime(2024,4,2,5,0,0), new DateTime(2025,1,2,5,30,5)) = -275.00:30:05
DateDiff(ToDateTime("2.1.2025 5:30:05"), ToDateTime("2.4.2024 5:00:00")) = 275.00:30:05
DateDiff(ToDateTime("2.4.2024 5:00:00"), [Employees.BirthDate]) = 13945.05:00:00
</syntaxhighlight>
 
== DateSerial ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|Second
! Функция !! Параметры !! Возвращаемое значение
|Возвращает текущую секунду минуты (0..59)
|<code>Second(<DateTime>)</code><br><code>=Second(Fields!SaleDate.Value)</code>
|-
|-
|TimeSerial
 
|Возвращает время, сложенное из часов+минут+секунд<br>См. так же DateSerial
| <code>DateSerial</code> || <code>int year, int month, int day</code> || <code>DateTime</code>
|<code>TimeSerial(<Hour Number>, <Minute Number>, <Second Number>)</code><br><code>=TimeSerial(DatePart("h", Fields!SaleDate.Value), DatePart("n", Fields!SaleDate.Value), DatePart("s", Fields!SalesDate.Value))</code>
|}
 
Создает новое значение <code>DateTime</code> из указанных года (<code>year</code>), месяца (<code>month</code>) и дня (<code>day</code>).
 
Еще один доступный способ для установки конкретной даты.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
DateSerial(2024,4,2) = 02.04.2024 0:00:00
</syntaxhighlight>
 
== Day ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|TimeValue
! Функция !! Параметры !! Возвращаемое значение
|Возвращает время в формате даты, полученное из строки.
|<code>TimeValue(<StringTime>)</code><br><code>=TimeValue("15:25:45"); TimeValue(Fields!SaleDate.Value)</code>
|-
|-
|TimeOfDay
 
|Возвращает текущее время в системе
| <code>Day</code> || <code>DateTime date</code> || <code>int</code>
|<code>TimeOfDay()</code><br><code>=TimeOfDay()</code>
|}
 
Извлекает день месяца (1-31) из указанной даты.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
Day(new DateTime(2024,4,2)) = 2
Day(ToDateTime("2.4.2024")) = 2
Day([Employees.BirthDate]) = 27
</syntaxhighlight>
 
== DayOfWeek ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|Timer
! Функция !! Параметры !! Возвращаемое значение
|Возвращает число с ПЗ - количество секунд, начиная с 00:00<br>Используется как счетчик производительности
|<code>Timer()</code><br><code>=Timer()</code>
|-
|-
|TimeString
 
|Возвращает строкой текущее время системы
| <code>DayOfWeek</code> || <code>DateTime date</code> || <code>string</code>
|<code>TimeString()</code><br><code>=TimeString()</code>
|}
 
Возвращает название дня недели (понедельник..воскресенье) указанной даты.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
DayOfWeek(new DateTime(2024,4,2)) = "вторник"
DayOfWeek(ToDateTime("2.4.2024")) = "вторник"
DayOfWeek([Employees.BirthDate]) = "понедельник"
</syntaxhighlight>
 
== DayOfYear ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|Weekday
! Функция !! Параметры !! Возвращаемое значение
|Возвращает числом номер текущего дня недели (1..7)
|<code>Weekday(<DateTime[,<DayOfWeek>])</code><br><code>=Weekday(Fields!SaleDate.Value,0)</code>
|-
|-
|WeekdayName
 
|Возвращает строкой название текущего дня недели. Работает с аббревиатурами, например, «пнд.», «вт.»
| <code>DayOfYear</code> || <code>DateTime date</code> || <code>int</code>
|<code>WeekdayName(<WeekDay>[,<Abbreviate[, <FirstDayOfWeek>]])</code><br><code>=WeekdayName(3, True, 0); =WeekDayName("w", Fields!SaleDate.Value), True, 0)</code>
|}
 
Возвращает порядковый номер дня в году (1-365) в указанной дате.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
DayOfYear(new DateTime(2024,4,2)) = 93
DayOfYear(ToDateTime("2.4.2024")) = 93
DayOfYear([Employees.BirthDate]) = 27
</syntaxhighlight>
 
== DaysInMonth ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|Year
! Функция !! Параметры !! Возвращаемое значение
|Возвращает числом номер текущего года
|<code>Year(<DateTime>)</code><br><code>=Year(Fields!SaleDate.Value)</code>
|-
|-
|Quarter
 
|Возвращает числом номер текущего квартала (1..4)
| <code>DaysInMonth</code> || <code>int year, int month</code> || <code>int</code>
|<code>Quarter(<DateTime>)</code><br><code>=Quarter(Fields!SaleDate.Value)</code>
|}
 
Возвращает количество дней в месяце month указанного года year.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
DaysInMonth(2024, 4) = 30
</syntaxhighlight>
 
== Hour ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|QuarterName
! Функция !! Параметры !! Возвращаемое значение
|Возвращает строкой номер текущего квартала (1..4)
|<code>QuarterName(<DateTime>)</code><br><code>=QuarterName(Fields!SaleDate.Value)</code>
|-
|-
| <code>Hour</code> || <code>DateTime date</code> || <code>int</code>
|}
|}


==Стандартные шаблоны форматирования даты и времени==
Извлекает час (0-23) из указанной даты.
{|class="wikitable" style="margin:auto; background-color: #fff;"  
 
'''Пример:'''
<syntaxhighlight lang="csharp">
Hour(new DateTime(2024,4,2,5,30,5)) = 5
Hour(ToDateTime("2.4.2024 5:30:05")) = 5
Hour([Employees.BirthDate]) = 0
</syntaxhighlight>
 
== Minute ==
{|class="wikitable" style="background-color: #fff;"  
|-
|-
!Шаблон
! Функция !! Параметры !! Возвращаемое значение
!Описание
!Пример
|-
|-
|"d"
 
|Короткая дата
| <code>Minute</code> || <code>DateTime date</code> || <code>int</code>
|17.10.2025<br>10/17/2025
|}
 
Извлекает минуты (0-59) из указанной даты.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
Minute(new DateTime(2024,4,2,5,30,5)) = 30
Minute(ToDateTime("2.4.2024 5:30:05")) = 30
Minute([Employees.BirthDate]) = 0
</syntaxhighlight>
 
== Month ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|"D"
! Функция !! Параметры !! Возвращаемое значение
|Длинная дата
|пятница, 17 октября 2025 г.<br>Friday, October 17, 2025
|-
|-
|"f"
 
|Полный формат (дата и короткое время)
| <code>Month</code> || <code>DateTime date</code> || <code>int</code>
|пятница, 17 октября 2025 г. 00:00<br>Friday, October 17, 2025 12:00 AM
|}
 
Извлекает месяц (1-12) из указанной даты.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
Month(new DateTime(2024,4,2)) = 4
Month(ToDateTime("2.4.2024")) = 4
Month([Employees.BirthDate]) = 1
</syntaxhighlight>
 
== MonthName ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|"F"
! Функция !! Параметры !! Возвращаемое значение
|Полный формат (дата и длинное время)
|пятница, 17 октября 2025 г. 00:00:00<br>Friday, October 17, 2025 12:00:00 AM
|-
|-
|"g"
 
|Общий формат (дата и короткое время)
| <code>MonthName</code> || <code>int month</code> || <code>string</code>
|17.10.2025 00:00<br>10/17/2025 12:00 AM
|}
 
Возвращает локализованное название месяца (Январь..Декабрь) с номером <code>month</code>.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
MonthName(1) = "Январь"
</syntaxhighlight>
 
== Second ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|"G"
! Функция !! Параметры !! Возвращаемое значение
|Общий формат (дата и длинное время)
|17.10.2025 00:00:00<br>10/17/2025 12:00:00 AM
|-
|-
|"M", "m"
 
|Месяц и день
| <code>Second</code> || <code>DateTime date</code> || <code>int</code>
|17 октября<br>October 17
|}
 
Извлекает секунды (0-59) из указанной даты.
 
'''Пример:'''
<syntaxhighlight lang="csharp">
Second(new DateTime(2024,4,2,5,30,5)) = 5
Second(ToDateTime("2.4.2024 5:30:05")) = 5
Second([Employees.BirthDate]) = 0
</syntaxhighlight>
 
== Year ==
{|class="wikitable" style="background-color: #fff;"
|-
|-
|"O", "o"
! Функция !! Параметры !! Возвращаемое значение
|Дата и время в формате round-trip (ISO 8601)
|2025-10-17T00:00:00.0000000+07:00<br>2025-10-17T00:00:00.0000000+07:00
|-
|"R", "r"
|Дата и время в формате RFC1123
|Fri, 17 Oct 2025 00:00:00 GMT<br>Fri, 17 Oct 2025 00:00:00 GMT
|-
|"s"
|Сортируемые дата и время
|2025-10-17T00:00:00<br>2025-10-17T00:00:00
|-
|"t"
|Короткое время
|00:00<br>12:00 AM
|-
|"T"
|Длинное время
|00:00:00<br>12:00:00 AM
|-
|"u"
|Универсальные сортируемые дата и время
|2025-10-17 00:00:00Z<br>2025-10-17 00:00:00Z
|-
|"U"
|Универсальные полные дата и время
|четверг, 16 октября 2025 г. 17:00:00<br>Thursday, October 16, 2025 5:00:00 PM
|-
|"Y", "y"
|Год и месяц
|октябрь 2025 г.<br>October 2025
|-
|-
| <code>Year</code> || <code>DateTime date</code> || <code>int</code>
|}
|}


==Примеры использования==
Извлекает год из указанной даты.
Выражение <code>=Format(Fields!input.Value, <Шаблон форматирования>)</code> форматирует значение даты из поля <code>Fields!input.Value</code> по вышеуказанным правилам форматирования (указываются в кавычках вместо <code><Шаблон форматирования></code>):
 
*<code>«dddd, d MMMM, yyyy»</code> = четверг, 18 декабрь, 2025
'''Пример:'''
*<code>«dd.MM.yyyy»</code> = 18.12.2025
<syntaxhighlight lang="csharp">
*<code>«d»</code> или <code>«dd»</code> = день месяца в числовом формате (например, «18»)
Year(new DateTime(2024,4,2)) = 2024
*<code>«ddd»</code> = день недели в коротком строковом формате (например, «чт» для четверга)
Year(ToDateTime("2.4.2024")) = 2024
*<code>«dddd»</code> = день недели в полном строковом формате (например, «четверг»)
Year([Employees.BirthDate]) = 1986
*<code>«MM»</code> = месяц в числовом формате (например, «12»)
</syntaxhighlight>
*<code>«MMM»</code> = месяц в коротком строковом формате (например, «дек.»)
*<code>«MMMM»</code> = месяц в коротком строковом формате (например, «декабрь»)
*<code>«y»</code> или <code>«yy»</code> = год в двузначном формате (например, «25» для 2025)
*<code>«yyyy»</code> = год в четырехзначном формате (например, «2025»)
*<code>«hh:mm»</code> = время в 12-часовом формате (например, «01:00» для 13:00)
*<code>«HH:mm»</code> = время в 24-часовом формате (например, «13:00» для 13:00)
*<code>«hh»</code> = часы в 12-часовом формате
*<code>«HH»</code> = часы в 24-часовом формате
*<code>«mm»</code> = минуты
*<code>«ss»</code> = секунды
'''Важное примечание:''' Для корректной работы функции Format входное поле должно иметь тип '''TIMESTAMP''' (или DateTime). Если в SQL-запросе используется приведение к типу '''DATE''', данные могут передаваться как строка, что приведет к игнорированию шаблона форматирования.

Текущая версия от 03:42, 19 октября 2026

Установка конкретной даты

Для установки конкретной даты можно использовать:

  • конструкторы структуры DateTime;
new DateTime(год, месяц, день, часы, минуты, секунды);
  • функцию ToDateTime (подробнее в разделе Конвертирование);
  • функцию DateSerial (рассматривается ниже).

Информация о времени

  • при использовании функций для преобразования даты из данного раздела по умолчанию сохраняется и информация о времени;
  • для удаления времени из даты можно воспользоваться функциями Format или FormatDateTime (более подробная информация об этих функциях представлена в разделе Форматирование).

Примечание

В качестве примера использования поля из базы данных в функциях будет использоваться условное поле [Employees.BirthDate]: 

[Employees.BirthDate] = 27.01.1986

AddDays

Функция Параметры Возвращаемое значение
AddDays DateTime date, double value DateTime

Добавляет к дате date количество дней value и возвращает новую дату.

Пример: 

AddDays(new DateTime(2024,4,2), 2) = 04.04.2024 0:00:00
AddDays(ToDateTime("2.4.2024"), 2) = 04.04.2024 0:00:00
AddDays([Employees.BirthDate], 2) = 29.01.1986 0:00:00

AddHours

Функция Параметры Возвращаемое значение
AddHours DateTime date, double value DateTime

Добавляет к дате date количество часов value и возвращает новую дату.

Пример: 

AddHours(new DateTime(2024,4,2,5,30,5), 1) = 02.04.2024 6:30:05
AddHours(ToDateTime("2.4.2024 5:30:05"), 1) = 02.04.2024 6:30:05
AddHours([Employees.BirthDate], 1) = 27.01.1986 1:00:00

AddMinutes

Функция Параметры Возвращаемое значение
AddMinutes DateTime date, double value DateTime

Добавляет к дате date количество минут value и возвращает новую дату.

Пример: 

AddMinutes(new DateTime(2024,4,2,5,30,5), 10) = 02.04.2024 5:40:05
AddMinutes(ToDateTime("2.4.2024 5:30:05"), 10) = 02.04.2024 5:40:05
AddMinutes([Employees.BirthDate], 10) = 27.01.1986 0:10:00

AddMonths

Функция Параметры Возвращаемое значение
AddMonths DateTime date, int value DateTime

Добавляет к дате date количество месяцев value и возвращает новую дату.

Пример: 

AddMonths(new DateTime(2024,4,2,5,30,5), 2) = 02.06.2024 5:30:05
AddMonths(ToDateTime("2.4.2024 5:30:05"), 2) = 02.06.2024 5:30:05
AddMonths([Employees.BirthDate], 2) = 27.03.1986 0:00:00

AddSeconds

Функция Параметры Возвращаемое значение
AddSeconds DateTime date, double value DateTime

Добавляет к дате date количество секунд value и возвращает новую дату.

Пример: 

AddSeconds(new DateTime(2024,4,2,5,30,5), 10) = 02.04.2024 5:30:15
AddSeconds(ToDateTime("2.4.2024 5:30:05"), 10) = 02.04.2024 5:30:15
AddSeconds([Employees.BirthDate], 10) = 27.01.1986 0:00:10

AddYears

Функция Параметры Возвращаемое значение
AddYears DateTime date, int value DateTime

Добавляет к дате date количество лет value и возвращает новую дату.

Пример: 

AddYears(new DateTime(2024,4,2,5,30,5), 3) = 02.04.2027 5:30:05
AddYears(ToDateTime("2.4.2024 5:30:05"), 3) = 02.04.2027 5:30:05
AddYears([Employees.BirthDate], 3) = 27.01.1989 0:00:00

DateDiff

Функция Параметры Возвращаемое значение
DateDiff DateTime date1, DateTime date2 TimeSpan

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

Пример: 

DateDiff(new DateTime(2024,4,2,5,0,0), new DateTime(2025,1,2,5,30,5)) = -275.00:30:05
DateDiff(ToDateTime("2.1.2025 5:30:05"), ToDateTime("2.4.2024 5:00:00")) = 275.00:30:05
DateDiff(ToDateTime("2.4.2024 5:00:00"), [Employees.BirthDate]) = 13945.05:00:00

DateSerial

Функция Параметры Возвращаемое значение
DateSerial int year, int month, int day DateTime

Создает новое значение DateTime из указанных года (year), месяца (month) и дня (day).

Еще один доступный способ для установки конкретной даты.

Пример: 

DateSerial(2024,4,2) = 02.04.2024 0:00:00

Day

Функция Параметры Возвращаемое значение
Day DateTime date int

Извлекает день месяца (1-31) из указанной даты.

Пример: 

Day(new DateTime(2024,4,2)) = 2
Day(ToDateTime("2.4.2024")) = 2
Day([Employees.BirthDate]) = 27

DayOfWeek

Функция Параметры Возвращаемое значение
DayOfWeek DateTime date string

Возвращает название дня недели (понедельник..воскресенье) указанной даты.

Пример: 

DayOfWeek(new DateTime(2024,4,2)) = "вторник"
DayOfWeek(ToDateTime("2.4.2024")) = "вторник"
DayOfWeek([Employees.BirthDate]) = "понедельник"

DayOfYear

Функция Параметры Возвращаемое значение
DayOfYear DateTime date int

Возвращает порядковый номер дня в году (1-365) в указанной дате.

Пример: 

DayOfYear(new DateTime(2024,4,2)) = 93
DayOfYear(ToDateTime("2.4.2024")) = 93
DayOfYear([Employees.BirthDate]) = 27

DaysInMonth

Функция Параметры Возвращаемое значение
DaysInMonth int year, int month int

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

Пример: 

DaysInMonth(2024, 4) = 30

Hour

Функция Параметры Возвращаемое значение
Hour DateTime date int

Извлекает час (0-23) из указанной даты.

Пример: 

Hour(new DateTime(2024,4,2,5,30,5)) = 5
Hour(ToDateTime("2.4.2024 5:30:05")) = 5
Hour([Employees.BirthDate]) = 0

Minute

Функция Параметры Возвращаемое значение
Minute DateTime date int

Извлекает минуты (0-59) из указанной даты.

Пример: 

Minute(new DateTime(2024,4,2,5,30,5)) = 30
Minute(ToDateTime("2.4.2024 5:30:05")) = 30
Minute([Employees.BirthDate]) = 0

Month

Функция Параметры Возвращаемое значение
Month DateTime date int

Извлекает месяц (1-12) из указанной даты.

Пример: 

Month(new DateTime(2024,4,2)) = 4
Month(ToDateTime("2.4.2024")) = 4
Month([Employees.BirthDate]) = 1

MonthName

Функция Параметры Возвращаемое значение
MonthName int month string

Возвращает локализованное название месяца (Январь..Декабрь) с номером month.

Пример: 

MonthName(1) = "Январь"

Second

Функция Параметры Возвращаемое значение
Second DateTime date int

Извлекает секунды (0-59) из указанной даты.

Пример: 

Second(new DateTime(2024,4,2,5,30,5)) = 5
Second(ToDateTime("2.4.2024 5:30:05")) = 5
Second([Employees.BirthDate]) = 0

Year

Функция Параметры Возвращаемое значение
Year DateTime date int

Извлекает год из указанной даты.

Пример: 

Year(new DateTime(2024,4,2)) = 2024
Year(ToDateTime("2.4.2024")) = 2024
Year([Employees.BirthDate]) = 1986
Источник — https://wiki.chemsoft.ru/index.php?title=Дата_и_время&oldid=4064