Объектная модель > Основные механизмы > Calendar

Для работы с датами используются:

•класс Calendar, который позволяет получить текущий год, дату, время и т.д.;

•методы объекта System.DateTime.

Особенности:

•запрещается получать текущее время через класс DateTime. Вместо DateTime.Today используйте Calendar.Today, а вместо DateTime.Now – Calendar.Now. Подробнее см. раздел «Разрешенные классы»;

•чтобы получить текущее время в часовом поясе веб-сервера, вместо SQL-функций getdate() и current_timestamp используйте метод Sungero.Core.SQL.AddCurrentDateParameter(), в котором явно передайте дату и время параметр CurrentDate со значением текущих даты и времени.

Даты и время в методах и свойствах класса Calendar рассчитываются с учетом календарей рабочего времени, частных календарей и часовых поясов. Календари содержат сведения о рабочем времени, выходных и праздничных днях в определенном году для компании или конкретного сотрудника. Например, в соответствии с календарями рабочего времени вычисляются сроки заданий.

Если для сотрудника задано несколько календарей рабочего времени, то учитывается приоритет календаря. Наибольший приоритет имеет частный календарь рабочего времени сотрудника и заданный часовой пояс, далее – частный календарь рабочего времени подразделения и заданный часовой пояс, далее – календарь рабочего времени компании в целом. Подробнее см. раздел «Календари рабочего времени».

Методы

Имя	Описание
AddWorkingDays() + 2 перегрузки	Добавить рабочие дни
AddWorkingHours() + 2 перегрузки	Добавить рабочие часы
BeginningOfDay()	Получить начало дня
BeginningOfMonth()	Получить начало месяца
BeginningOfWeek()	Получить начало недели
BeginningOfWorkingDay() + 2 перегрузки	Получить начало рабочего дня
BeginningOfWorkingMonth() + 2 перегрузки	Получить начало первого рабочего дня в месяце
BeginningOfWorkingYear() + 2 перегрузки	Получить начало первого рабочего дня в году
BeginningOfYear()	Получить начало года
Between()	Проверить, находится ли дата в указанном периоде
CalculateDeadline() + 2 перегрузки	Получить срок завершения задания
EndOfDay()	Получить конец дня
EndOfMonth()	Получить конец месяца
EndOfWeek()	Получить конец недели
EndOfWorkingDay() + 2 перегрузки	Получить конец рабочего дня
EndOfWorkingMonth() + 2 перегрузки	Получить конец последнего рабочего дня в месяце
EndOfWorkingYear() + 2 перегрузки	Получить конец последнего рабочего дня в году
EndOfYear()	Получить конец года
FromUserTime() + 4 перегрузки	Преобразовать дату и время
FromUtcTime() + 2 перегрузки	Преобразовать дату и время из UTC
GetDate()	Получить дату
GetUserNow()	Получить локальные дату и время для указанного сотрудника, подразделения или нашей организации
GetUserToday()	Получить локальную дату для указанного сотрудника, подразделения или нашей организации
HasTime()	Проверить, указана ли дата со временем
IsLunchTime()	Проверить, выпадают ли дата и время на обеденный перерыв
IsWorkingDay() + 2 перегрузки	Проверить, является ли день рабочим по календарю рабочего времени
IsWorkingTime() + 3 перегрузки	Проверить, являются ли дата и время рабочими по календарю рабочего времени
NextDay()	Получить начало следующего дня
NextMonth()	Получить начало следующего месяца
NextWeek()	Получить начало следующей недели
NextWorkingDay() + 2 перегрузки	Получить дату следующего рабочего дня
NextYear()	Получить начало следующего года
PreviousDay()	Получить начало предыдущего дня
PreviousMonth()	Получить начало предыдущего месяца
PreviousWeek()	Получить начало предыдущей недели
PreviousWorkingDay() + 2 перегрузки	Получить дату предыдущего рабочего дня
PreviousYear()	Получить начало предыдущего года
ToUserTime() + 4 перегрузки	Преобразовать дату и время текущего пользователя
ToUtcTime() + 2 перегрузки	Преобразовать дату и время веб-сервера в формат UTC

Свойства

Имя	Тип	Описание
Now	DateTime	Текущие дата и время веб-сервера
Today	DateTime	Текущая дата веб-сервера
UserNow	DateTime	Локальные даты и время текущего пользователя
UserToday	DateTime	Локальная дата пользователя
UtcOffset	TimeSpan	Смещение даты и времени веб-сервера от UTC

Примечание. Для фильтрации по датам, когда нужно задать неограниченные периоды, используются Calendar.SqlMinValue – минимальное значение даты, поддерживаемое SQL-сервером, а также Calendar.SqlMaxValue – максимальное значение даты, поддерживаемое SQL-сервером.

Пример 1. Получение следующего\предыдущего рабочего дня

// Свойство Today – текущая дата веб-сервера.
var newDate = Calendar.Today.NextWorkingDay();
var newDate = Calendar.Today.PreviousWorkingDay();

Пример 2. Добавление времени к дате

// К текущей дате добавить дни/часы и округлить до ближайшей рабочей даты.
var newDate = Calendar.Today.AddWorkingDays(7);
var newDate = Calendar.Now.AddWorkingHours(5);

Пример 3. Проверка того, что текущие дата и время являются рабочим временем

// Свойство Now – текущие дата и время веб-сервера.
var now = Calendar.Now;
if (now.IsWorkingTime())
  return true;

Пример 4. Проверка того, что для текущего пользователя день является рабочим

var isWorkingDay = Calendar.Now.IsWorkingDay(Employees.Current)

Данный вариант учитывает частные календари рабочего времени. У других методов класса Calendar, например, у AddWorkingDays(), EndOfWorkingDay(), также существуют перегрузки, позволяющие получить значение с учетом частных календарей указанных пользователей или групп пользователей.

СМ. ТАКЖЕ