Класс System::DateTime
Содержание
[
Скрывать
]DateTime class
Представляет конкретное значение даты и времени на временной шкале. Этот тип должен быть размещён в стеке и передаваться в функции по значению или по ссылке. Никогда не используйте класс System::SmartPtr для управления объектами этого типа.
class DateTime
Методы
| Метод | Описание |
|---|---|
| Add(TimeSpan) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, полученное в результате добавления указанного интервала времени к значению даты и времени, представленному текущим объектом. |
| AddDays(double) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, которое является суммой значения, представленного текущим объектом, и указанного количества дней. |
| AddHours(double) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, которое является суммой значения, представленного текущим объектом, и указанного количества часов. |
| AddMilliseconds(double) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, которое является суммой значения, представленного текущим объектом, и указанного количества миллисекунд. |
| AddMinutes(double) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, которое является суммой значения, представленного текущим объектом, и указанного количества минут. |
| AddMonths(int) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, которое является суммой значения, представленного текущим объектом, и указанного количества месяцев. |
| AddSeconds(double) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, которое является суммой значения, представленного текущим объектом, и указанного количества секунд. |
| AddTicks(int64_t) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, которое является суммой значения, представленного текущим объектом, и указанного количества интервалов в 100 наносекунд. |
| AddYears(int) const | Возвращает новый экземпляр класса DateTime, представляющий значение даты и времени, равное значению, представленному текущим объектом, с увеличенным на указанное число компонентом года. |
| static Compare(DateTime, DateTime) | Сравнивает два значения, представленные указанными экземплярами класса DateTime, и возвращает значение, указывающее относительные позиции значений на временной линии. |
| CompareTo(DateTime) const | Сравнивает два значения даты и времени, представленные текущим объектом и указанным экземпляром класса DateTime, и возвращает значение, указывающее относительные позиции значений на временной линии. |
| DateTime() | Создаёт экземпляр, представляющий наименьшее возможное значение даты и времени, равное MinValue. |
| DateTime(int, int, int) | Создает экземпляр, представляющий значение даты и времени, указанное конкретным годом, месяцем и днём. |
| DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&) | Создает экземпляр, представляющий значение даты и времени, указанное конкретным годом, месяцем и днём в указанном календаре. |
| DateTime(int, int, int, int, int, int) | Создает экземпляр, представляющий значение даты и времени, указанное конкретным годом, месяцем, днём, часом, минутой и секундой. |
| DateTime(int, int, int, int, int, int, DateTimeKind) | Создает экземпляр, представляющий значение даты и времени, указанное конкретным годом, месяцем, днём, часом, минутой и секундой. |
| DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&) | Создает экземпляр, представляющий значение даты и времени, указанное конкретным годом, месяцем, днём, часом, минутой и секундой в указанном календаре. |
| DateTime(int, int, int, int, int, int, int, DateTimeKind) | Создает экземпляр, представляющий значение даты и времени, указанное конкретным годом, месяцем, днём, часом, минутой, секундой и миллисекундой. |
| DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind) | Создает экземпляр, представляющий значение даты и времени, указанное конкретным годом, месяцем, днём, часом, минутой, секундой и миллисекундой в указанном календаре. |
| DateTime(int64_t, DateTimeKind) | Создаёт экземпляр, представляющий значение даты и времени, указанное числом тиков. |
| DateTime(int64_t, DateTimeKind, bool) | Создаёт экземпляр, представляющий значение даты и времени, указанное числом тиков. ДЛЯ ВНУТРЕННЕГО ИСПОЛЬЗОВАНИЯ. |
| DateTime(const DateTime&) | Создаёт копию экземпляра. |
| static DaysInMonth(int, int) | Возвращает количество дней в указанном месяце указанного года. |
| static Equals(DateTime, DateTime) | Определяет, представляют ли указанные экземпляры класса DateTime одинаковое значение даты и времени. |
| Equals(DateTime) const | Определяет, представляет ли указанный экземпляр класса DateTime то же значение даты и времени, что и текущий объект. |
| static FromBinary(int64_t) | Десериализует значение даты и времени из указанного беззнакового 64‑битного целого числа и устанавливает новое значение экземпляра класса DateTime равным этому значению. |
| static FromFileTime(int64_t) | Преобразует указанное файловое время в экземпляр класса DateTime, представляющий то же значение даты и времени, что и локальное время. |
| static FromFileTimeUtc(int64_t) | Преобразует указанное файловое время в экземпляр класса DateTime, представляющий то же значение даты и времени, что и время UTC. |
| static FromOADate(double) | Возвращает экземпляр класса DateTime, представляющий значение даты и времени, эквивалентное указанной дате OLE Automation. |
| static FromUnixTime(time_t) | Преобразует указанное значение времени Unix в экземпляр класса DateTime. ДЛЯ ВНУТРЕННЕГО ИСПОЛЬЗОВАНИЯ. |
| get_Date() const | Возвращает новый экземпляр класса DateTime, представляющий дату из даты и времени, представленных текущим объектом, при этом все компоненты времени установлены в 0. |
| get_Day() const | Возвращает порядковый номер дня в месяце, представленный текущим объектом. |
| get_DayOfWeek() const | Возвращает значение, представляющее день недели, представленный текущим объектом. |
| get_DayOfYear() const | Возвращает порядковый номер дня в году, представленный текущим объектом. |
| get_Hour() const | Возвращает компонент часа значения даты и времени, представленного текущим объектом. |
| get_Kind() const | Возвращает значение, указывающее, является ли дата и время, представленные текущим объектом, локальными, UTC или ни тем, ни другим. |
| get_Millisecond() const | Возвращает компонент миллисекунды значения даты и времени, представленного текущим объектом. |
| get_Minute() const | Возвращает компонент минуты значения даты и времени, представленного текущим объектом. |
| get_Month() const | Возвращает порядковый номер месяца в году, представленный текущим объектом. |
| static get_Now() | Возвращает экземпляр класса DateTime, представляющий текущее время как локальное. |
| get_Second() const | Возвращает компонент секунд даты и времени, представленный текущим объектом. |
| get_Ticks() const | Возвращает количество 100-наносекундных интервалов, прошедших с 0:00:00 UTC, 1 января 0001 года по григорианскому календарю до даты и времени, представленных текущим объектом. |
| get_TimeOfDay() const | Возвращает значение, представляющее интервал времени от начала дня, представленного текущим объектом, до даты и времени, представленных текущим объектом. |
| static get_Today() | Возвращает экземпляр класса DateTime, представляющий текущую дату, при этом каждый компонент временной части значения, представленного объектом, установлен в 0. |
| static get_UtcNow() | Возвращает экземпляр класса DateTime, представляющий текущее время в формате UTC. |
| get_Year() const | Возвращает год, представленный текущим объектом. |
| GetDateComponents(int&, int&, int&) const | Получает части даты. ДЛЯ ВНУТРЕННЕГО ИСПОЛЬЗОВАНИЯ. |
| GetDateTimeFormats() const | Возвращает массив строк, где каждый элемент представляет строковое представление текущего объекта, отформатированное с помощью одного из стандартных спецификаторов формата даты и времени. |
| GetDateTimeFormats(char_t) const | Возвращает массив строк, где каждый элемент представляет строковое представление текущего объекта, отформатированное с указанным стандартным спецификатором формата даты и времени. |
| GetDateTimeFormats(const SharedPtr<IFormatProvider>&) const | Возвращает массив строк, где каждый элемент представляет строковое представление текущего объекта, отформатированное с помощью одного из стандартных спецификаторов формата даты и времени и указанного поставщика формата. |
| GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) const | Возвращает массив строк, где каждый элемент представляет строковое представление текущего объекта, отформатированное с указанным стандартным спецификатором формата даты и времени и поставщиком формата. |
| GetHashCode() const | Возвращает хеш‑код текущего объекта. |
| IsDaylightSavingTime() const | Определяет, попадает ли значение даты и времени, представленного текущим объектом, в диапазон летнего времени для текущего часового пояса. |
| static IsLeapYear(int) | Определяет, является ли указанный год високосным. |
| IsNull() const | |
| operator!=(DateTime) const | Определяет, представляют ли текущий объект и указанный объект DateTime разные значения даты и времени. |
| operator!=(std::nullptr_t) const | |
| operator+(TimeSpan) const | Возвращает новый экземпляр класса DateTime, представляющий дату и время, полученные в результате сложения значения, представленного текущим объектом, и указанного интервала времени. |
| operator+=(TimeSpan) | Устанавливает текущий объект в значение даты и времени, полученное в результате сложения значения, представленного текущим объектом, и указанного интервала времени. |
| operator-(TimeSpan) const | Возвращает новый экземпляр класса DateTime, представляющий дату и время, полученные в результате вычитания указанного интервала времени из значения, представленного текущим объектом. |
| operator-(DateTime) const | Возвращает экземпляр класса TimeSpan, который представляет временной интервал между значениями даты и времени, представленными текущим и указанным объектами. |
| operator-=(TimeSpan) | Устанавливает текущий объект в значение даты и времени, полученное в результате вычитания указанного интервала времени из значения даты и времени, представленного текущим объектом. |
| operator<(DateTime) const | Определяет, представляет ли текущий объект дату и время, которые предшествуют значению, представленному указанным объектом DateTime. |
| operator<(std::nullptr_t) const | |
| operator<=(DateTime) const | Определяет, представляет ли текущий объект дату и время, которые предшествуют или совпадают со значением, представленным указанным объектом DateTime. |
| operator<=(std::nullptr_t) const | |
| operator=(const DateTime&) | Присваивает значение, представленное указанным экземпляром DateTime, текущему объекту. |
| operator==(DateTime) const | Определяет, представляют ли текущий объект и указанный объект DateTime одинаковое значение даты и времени. |
| operator==(std::nullptr_t) const | |
| operator>(DateTime) const | Определяет, представляет ли текущий объект дату и время, которые позже значения, представленного указанным объектом DateTime. |
| operator>(std::nullptr_t) const | |
| operator>=(DateTime) const | Определяет, представляет ли текущий объект значение даты и времени, которое позже или равно значению, представленному указанным объектом DateTime. |
| operator>=(std::nullptr_t) const | |
| static Parse(const String&) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime. |
| static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime, используя информацию о формате, специфичную для культуры. |
| static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static Parse(const String&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime, используя указанный формат и информацию о формате, специфичную для культуры. Формат строкового представления должен точно соответствовать указанному формату. Выбрасывает исключение, если преобразование не удалось. |
| static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime, используя указанные форматы, информацию о формате, специфичную для культуры, и стиль. Формат строкового представления должен точно соответствовать одному или нескольким из указанных форматов. Выбрасывает исключение, если преобразование не удалось. |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static SpecifyKind(DateTime, DateTimeKind) | Создаёт новый объект DateTime, который представляет то же количество тиков, что и указанный объект DateTime, и представляет локальное время, время UTC или ни то, ни другое в зависимости от аргумента kind. |
| Subtract(TimeSpan) const | Возвращает новый экземпляр класса DateTime, представляющий дату и время, полученные в результате вычитания указанного интервала времени из значения, представленного текущим объектом. |
| Subtract(DateTime) const | Возвращает экземпляр класса TimeSpan, представляющий интервал времени между значениями даты и времени, представленными текущим и указанным объектами. |
| ToBinary() const | Сериализует текущий объект. |
| ToFileTime() const | Возвращает значение, представляющее дату и время, представленные текущим объектом, в виде файлового времени. |
| ToFileTimeUtc() const | Преобразует значение даты и времени, представленное текущим объектом, в файловое время UTC. |
| ToLocalTime() const | Возвращает новый экземпляр класса DateTime, который представляет дату и время, представленные текущим объектом, как локальное время. |
| ToLongDateString() const | Возвращает строку, содержащую полное строковое представление даты текущего объекта. |
| ToLongTimeString() const | Возвращает строку, содержащую полное строковое представление времени текущего объекта. |
| ToOADate() const | Возвращает значение даты и времени, представленное текущим объектом, в виде OLE Automation Date. |
| ToShortDateString() const | Возвращает строку, содержащую краткое строковое представление даты текущего объекта. |
| ToShortTimeString() const | Возвращает строку, содержащую краткое строковое представление времени текущего объекта. |
| ToString() const | Возвращает строковое представление значения даты и времени, представленного текущим объектом, используя правила форматирования, определённые текущей культурой. |
| ToString(const String&) const | Возвращает строковое представление значения даты и времени, представленного текущим объектом, используя указанный формат и правила форматирования, определённые текущей культурой. |
| ToString(const SharedPtr<IFormatProvider>&) const | Возвращает строковое представление значения даты и времени, представленного текущим объектом, используя указанную информацию о формате. |
| ToString(const SharedPtr<Globalization::CultureInfo>&) const | |
| ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const | |
| ToString(std::nullptr_t) const | |
| ToString(const String&, const SharedPtr<IFormatProvider>&) const | Возвращает строковое представление значения даты и времени, представленного текущим объектом, используя указанную информацию о формате. |
| ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const | |
| ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const | |
| ToString(const String&, std::nullptr_t) const | |
| ToUniversalTime() const | Возвращает новый экземпляр класса DateTime, который представляет дату и время, представленные текущим объектом, как UTC. |
| ToUnixTime() const | Возвращает значение, представляющее дату и время, представленные текущим объектом, в виде Unix‑времени. ДЛЯ ВНУТРЕННЕГО ИСПОЛЬЗОВАНИЯ. |
| static TryParse(const String&, DateTime&) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime. |
| static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime, используя указанную информацию о формате, специфичную для культуры, и стиль. |
| static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParse(const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime, используя указанный формат, информацию о формате, специфичную для культуры, и стиль. Формат строкового представления должен точно соответствовать указанному формату. |
| static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | Преобразует указанное строковое представление значения даты и времени в эквивалентный объект DateTime, используя указанные форматы, информацию о формате, специфичную для культуры, и стиль. Формат строкового представления должен точно соответствовать одному или нескольким из указанных форматов. |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static Type() | Возвращает объект TypeInfo, содержащий информацию об этом классе. |
Поля
| Поле | Описание |
|---|---|
| static constexpr MaxTicks | Количество 100-наносекунд в интервале времени между минимально возможным и максимально возможным значением DateTime. |
| static MaxValue | Экземпляр класса DateTime, представляющий максимально возможную дату и время. |
| static constexpr MinTicks | Минимальное количество тиков, которое может представлять экземпляр класса DateTime. |
| static MinValue | Экземпляр класса DateTime, представляющий минимально возможную дату и время. |
| static constexpr TicksPerDay | Количество тиков в дне. |
| static constexpr TicksPerHour | Количество тиков в часе. |
| static constexpr TicksPerMicrosecond | Количество тиков в микросекунде. |
| static constexpr TicksPerMillisecond | Количество тиков в миллисекунде. |
| static constexpr TicksPerMinute | Количество тиков в минуте. |
| static constexpr TicksPerSecond | Количество тиков в секунде. |
| static UnixEpoch | Экземпляр класса DateTime, представляющий начало эпохи Unix (1970-01-01 00:00:00). |
Примечания
#include "system/console.h"
#include "system/date_time.h"
int main()
{
using namespace System;
// Создайте экземпляр класса 'DateTime'.
DateTime dateTime{1990, 10, 30};
// Выведите экземпляр в нескольких форматах.
Console::WriteLine(dateTime.ToShortDateString());
Console::WriteLine(dateTime.ToShortTimeString());
Console::WriteLine(dateTime.ToString());
return 0;
}
/*
This code example produces the following output:
30.10.1990
0:00
30.10.1990 0:00:00
*/
См. также
- Namespace System
- Library Aspose.Font for C++
