Class DateTimeUtilities
Содержит служебные методы для работы с датой и временем.
Inheritance
Inherited Members
Namespace: Terrasoft.Common
Assembly: Terrasoft.Common.dll
Syntax
public static class DateTimeUtilities
Properties
JavascriptMinDateTime
Javascript date object min value.
Declaration
public static DateTime JavascriptMinDateTime { get; }
Property Value
Type | Description |
---|---|
System.DateTime |
Methods
DateTimeToDate(DateTime, Int32, Boolean)
Returns new instance of class System.DateTime, which equals received instance System.DateTime with additional days.
Declaration
public static DateTime DateTimeToDate(DateTime value, int dayOffset = 0, bool useSpecifiedKind = false)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | Base value of date and time. |
System.Int32 | dayOffset | Days offset. Parameter |
System.Boolean | useSpecifiedKind | Use |
Returns
Type | Description |
---|---|
System.DateTime | Instance of System.DateTime, which value is equal to the sum of the date and time,
provided from parameters |
Remarks
Instance of System.DateTime contains only Date component of date.
DateTimeToShortTime(DateTime, Int32)
Declaration
public static TimeSpan DateTimeToShortTime(DateTime value, int minuteOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | |
System.Int32 | minuteOffset |
Returns
Type | Description |
---|---|
System.TimeSpan |
Day(DateTime)
Возвращает день месяца для даты.
Declaration
public static int Day(DateTime datetime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | datetime | Дата типа System.DateTime. |
Returns
Type | Description |
---|---|
System.Int32 | День месяца в диапазоне от 1 до 31. |
DayInRange(DateTime, DateTime, Int32, Int32)
Возвращает истину, если день даты datetime1 лежит в диапазоне datetime2 – BeforeDays и datetime2 + AfterDays.
Declaration
public static bool DayInRange(DateTime datetime1, DateTime datetime2, int daysBefore, int daysAfter)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | datetime1 | Проверяемая дата. |
System.DateTime | datetime2 | Дата, задающая диапазон. |
System.Int32 | daysBefore | Количество дней до даты datetime2 (нижняя граница диапазона) |
System.Int32 | daysAfter | Количество дней после даты datetime2 (верхняя граница диапазона) |
Returns
Type | Description |
---|---|
System.Boolean |
DayOfWeek(DateTime)
Возвращает номер дня недели для даты.
Declaration
public static int DayOfWeek(DateTime datetime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | datetime | Дата типа System.DateTime. |
Returns
Type | Description |
---|---|
System.Int32 | Номер дня недели: 1 - понедельник, 7 - воскресенье. |
GetDateTimeTillMillisecond(DateTime)
Declaration
public static DateTime GetDateTimeTillMillisecond(DateTime dateTime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | dateTime |
Returns
Type | Description |
---|---|
System.DateTime |
GetDateTimeTillMillisecondRounded(DateTime)
Declaration
public static DateTime GetDateTimeTillMillisecondRounded(DateTime dateTime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | dateTime |
Returns
Type | Description |
---|---|
System.DateTime |
GetDateTimeTillMinutes(DateTime)
Declaration
public static DateTime GetDateTimeTillMinutes(DateTime dateTime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | dateTime |
Returns
Type | Description |
---|---|
System.DateTime |
GetDateTimeTillSeconds(DateTime)
Declaration
public static DateTime GetDateTimeTillSeconds(DateTime dateTime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | dateTime |
Returns
Type | Description |
---|---|
System.DateTime |
GetQuarter(DateTime)
Declaration
public static int GetQuarter(this DateTime source)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | source |
Returns
Type | Description |
---|---|
System.Int32 |
GetTimeTillMinutes(TimeSpan, Int32)
Получение времени с точностью до минут.
Declaration
public static TimeSpan GetTimeTillMinutes(TimeSpan value, int minuteOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.TimeSpan | value | Значение времени. |
System.Int32 | minuteOffset | Смещение в минутах. |
Returns
Type | Description |
---|---|
System.TimeSpan | Экземпляр System.TimeSpan, который представляет часы и минуты,
переданных параметром |
IsDate(DateTime)
Declaration
public static bool IsDate(DateTime value)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value |
Returns
Type | Description |
---|---|
System.Boolean |
Month(DateTime)
Возвращает месяц для даты.
Declaration
public static int Month(DateTime datetime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | datetime | Дата типа System.DateTime. |
Returns
Type | Description |
---|---|
System.Int32 | Месяц в диапазоне от 1 до 12. |
StartOfHalfYear(DateTime, Int32)
Дата начала полугодия для переданного экземпляра System.DateTime.
Declaration
public static DateTime StartOfHalfYear(DateTime value, int halfYearOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | Значение даты и времени. |
System.Int32 | halfYearOffset | Смещение в полугодиях. Параметр |
Returns
Type | Description |
---|---|
System.DateTime | Экземпляр System.DateTime, который представляет первый день полугодия для даты и
времени, переданных параметром |
StartOfHour(DateTime, Int32)
Дата начала часа для переданного экземпляра System.DateTime.
Declaration
public static DateTime StartOfHour(DateTime value, int hourOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | Значение даты и времени. |
System.Int32 | hourOffset | Смещение в часах. Параметр |
Returns
Type | Description |
---|---|
System.DateTime | Экземпляр System.DateTime, который представляет первую минуту часа для даты и
времени, переданных параметром |
StartOfMonth(DateTime, Int32)
Дата начала месяца для переданного экземпляра System.DateTime.
Declaration
public static DateTime StartOfMonth(DateTime value, int monthOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | Значение даты и времени. |
System.Int32 | monthOffset | Смещение в кварталах. Параметр |
Returns
Type | Description |
---|---|
System.DateTime | Экземпляр System.DateTime, который представляет первый день месяца для даты и
времени, переданных параметром |
StartOfQuarter(DateTime, Int32)
Дата начала квартала для переданного экземпляра System.DateTime.
Declaration
public static DateTime StartOfQuarter(DateTime value, int quarterOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | Значение даты и времени. |
System.Int32 | quarterOffset | Смещение в днях. Параметр |
Returns
Type | Description |
---|---|
System.DateTime | Экземпляр System.DateTime, который представляет первый день квартала для даты и
времени, переданных параметром |
StartOfWeek(DateTime, Int32)
Start date of the week for a given value System.DateTime
with week offset weekOffset
.
Declaration
public static DateTime StartOfWeek(DateTime value, int weekOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | Date and time value. |
System.Int32 | weekOffset | The week offset. Parametr |
Returns
Type | Description |
---|---|
System.DateTime | Instance System.DateTime, which is the first day of the week for the date and
time for a given value |
StartOfYear(DateTime, Int32)
Дата начала года для переданного экземпляра System.DateTime.
Declaration
public static DateTime StartOfYear(DateTime value, int yearOffset = 0)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | value | Значение даты и времени. |
System.Int32 | yearOffset | Смещение в годах. Параметр |
Returns
Type | Description |
---|---|
System.DateTime | Экземпляр System.DateTime, который представляет первый день года для даты и
времени, переданных параметром |
Time(DateTime)
Возвращает время дня для даты.
Declaration
public static TimeSpan Time(DateTime datetime)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | datetime | Дата типа System.DateTime. |
Returns
Type | Description |
---|---|
System.TimeSpan | Время дня типа System.TimeSpan. |
Time(String)
Возвращает время, заданное строкой.
Declaration
public static TimeSpan Time(string timeString)
Parameters
Type | Name | Description |
---|---|---|
System.String | timeString | Время, заданное в формате "чч:мм" или "ч:мм". |
Returns
Type | Description |
---|---|
System.TimeSpan | Время дня типа System.TimeSpan. |
ToJsonFormat(DateTime, TimeSpan)
Declaration
public static string ToJsonFormat(this DateTime source, TimeSpan utcOffset)
Parameters
Type | Name | Description |
---|---|---|
System.DateTime | source | |
System.TimeSpan | utcOffset |
Returns
Type | Description |
---|---|
System.String |