Calendar Класс

Определение

Пространство имен:

Windows.Globalization

Управляет представлением даты и времени в пределах заданного календаря и часов.

public ref class Calendar sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ICalendarFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ICalendarFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class Calendar final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ICalendarFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ICalendarFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Calendar

function Calendar(languages, calendar, clock, timeZoneId)

Public NotInheritable Class Calendar

Наследование

Object Platform::Object IInspectable Calendar

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Если приложение передает языковые теги, используемые в этом классе, в какие-либо функции поддержки национальных языков , оно должно сначала преобразовать теги, вызвав ResolveLocaleName.

Языковые теги поддерживают расширения Юникода "ca-" и "nu-". (См . раздел Определения ключа и типа Юникода.) Обратите внимание, что эти расширения могут влиять на календарь, используемый объектами Calendar.

Конструкторы

Calendar()	Создает объект Calendar и инициализирует его текущим значением DateTime.
Calendar(IIterable<String>)	Создает объект Calendar , инициализируемый списком языков.
Calendar(IIterable<String>, String, String)	Создает объект Calendar , инициализируемый списком языков, календарем и часами.
Calendar(IIterable<String>, String, String, String)	Создает объект Calendar , инициализируемый со списком языков, календарем, часами и часовым поясом.

Свойства

Day	Возвращает или задает день.
DayOfWeek	Возвращает день недели.
Era	Возвращает или задает эру.
FirstDayInThisMonth	Возвращает первый день текущего месяца.
FirstEra	Возвращает первую эру , доступную в календаре.
FirstHourInThisPeriod	Возвращает первый час текущего периода.
FirstMinuteInThisHour	Возвращает первую минуту текущего часа.
FirstMonthInThisYear	Возвращает первый месяц текущего года.
FirstPeriodInThisDay	Возвращает первый период текущего дня.
FirstSecondInThisMinute	Возвращает первую секунду текущей минуты.
FirstYearInThisEra	Получает первый год текущей эры.
Hour	Возвращает или задает час.
IsDaylightSavingTime	Возвращает логическое значение, указывающее, действует ли летнее время для даты этого объекта Calendar .
Languages	Возвращает список приоритетов идентификаторов языка, используемых при форматировании компонентов в виде строк.
LastDayInThisMonth	Возвращает последний день текущего месяца.
LastEra	Возвращает последнюю эру , доступную в календаре.
LastHourInThisPeriod	Возвращает последний час текущего периода.
LastMinuteInThisHour	Возвращает последнюю минуту текущего часа.
LastMonthInThisYear	Возвращает последний месяц текущего года.
LastPeriodInThisDay	Возвращает последний период текущего дня.
LastSecondInThisMinute	Возвращает последнюю секунду текущей минуты.
LastYearInThisEra	Получает последний год текущей эры.
Minute	Возвращает или задает минуту.
Month	Возвращает или задает месяц.
Nanosecond	Возвращает или задает наносекунда.
NumberOfDaysInThisMonth	Возвращает количество дней в текущем месяце этого объекта Calendar .
NumberOfEras	Возвращает количество эр в этом объекте Calendar .
NumberOfHoursInThisPeriod	Возвращает количество часов в текущем дневном периоде этого объекта Calendar .
NumberOfMinutesInThisHour	Возвращает количество минутв текущем часе.
NumberOfMonthsInThisYear	Возвращает количество месяцев в текущем году этого объекта Calendar .
NumberOfPeriodsInThisDay	Возвращает количество периодов в текущем дне этого объекта Calendar .
NumberOfSecondsInThisMinute	Возвращает число секундв текущей минуте.
NumberOfYearsInThisEra	Возвращает количество лет в текущей эре данного объекта Calendar .
NumeralSystem	Возвращает или задает систему нумерации, которая используется при форматировании компонентов в виде строк.
Period	Возвращает или задает период текущего дня.
ResolvedLanguage	Возвращает язык, который последний раз использовался для выполнения форматирования календаря или операций.
Second	Возвращает или задает секунду.
Year	Возвращает или задает год.

Методы

AddDays(Int32)	Увеличивает или уменьшает день.
AddEras(Int32)	Увеличивает или уменьшает эру.
AddHours(Int32)	Увеличивает или уменьшает час.
AddMinutes(Int32)	Увеличивает или уменьшает минуту.
AddMonths(Int32)	Увеличивает или уменьшает месяц.
AddNanoseconds(Int32)	Увеличивает или уменьшает наносекунда.
AddPeriods(Int32)	Увеличивает или уменьшает период.
AddSeconds(Int32)	Увеличивает или уменьшает секунду.
AddWeeks(Int32)	Увеличивает или уменьшает день на указанное количество недель.
AddYears(Int32)	Увеличивает или уменьшает год.
ChangeCalendarSystem(String)	Задает новую систему календаря, используемую этим объектом Calendar .
ChangeClock(String)	Задает новые часы, используемые этим объектом Calendar .
ChangeTimeZone(String)	Задает новый часовой пояс, используемый этим объектом Calendar .
Clone()	Создает копию объекта Calendar .
Compare(Calendar)	Сравнивает этот календарь с другим объектом Calendar и указывает, является ли значение DateTime одного из них более ранним, равным или более поздним, чем у другого.
CompareDateTime(DateTime)	Сравнивает этот календарь с объектом DateTime и указывает, являются ли дата и время одного из них более ранними, равными или более поздними, чем у другого.
CopyTo(Calendar)	Копирует значения из другого объекта Calendar в этот календарь.
DayAsPaddedString(Int32)	Возвращает строковое представление дня( при необходимости с нулевой заполнением).
DayAsString()	Возвращает строку, содержащую числовое представление дня.
DayOfWeekAsSoloString()	Возвращает строковое представление дня недели, подходящего для автономного отображения.
DayOfWeekAsSoloString(Int32)	Возвращает строковое представление дня недели, подходящего для автономного отображения.
DayOfWeekAsString()	Возвращает строковое представление дня недели, подходящее для включения с другими компонентами даты.
DayOfWeekAsString(Int32)	Возвращает строковое представление дня недели, подходящее для включения с другими компонентами даты.
EraAsString()	Возвращает строковое представление эпохи.
EraAsString(Int32)	Возвращает строковое представление эпохи. Выбранная строка ближе всего по длине к идеальной длине.
GetCalendarSystem()	Возвращает систему календаря, используемую этим объектом Calendar .
GetClock()	Возвращает часы, используемые этим объектом Calendar .
GetDateTime()	Создает дату и время с учетом компонентов этого объекта Calendar .
GetTimeZone()	Возвращает идентификатор, определяющий часовой пояс, используемый этим объектом Calendar .
HourAsPaddedString(Int32)	Возвращает строковое представление часа( при необходимости с нулевой заполнением).
HourAsString()	Возвращает строку, содержащую числовое представление часа.
MinuteAsPaddedString(Int32)	Возвращает строковое представление минуты( при необходимости с нулевой заполнением).
MinuteAsString()	Возвращает строку, содержащую числовое представление минуты.
MonthAsNumericString()	Возвращает строку, содержащую числовое представление месяца.
MonthAsPaddedNumericString(Int32)	Возвращает строковое представление месяца( при необходимости с нулевой заполнением).
MonthAsSoloString()	Возвращает строковое представление месяца, подходящего для автономного отображения.
MonthAsSoloString(Int32)	Возвращает строковое представление месяца, подходящего для автономного отображения.
MonthAsString()	Возвращает строковое представление месяца, подходящего для включения с другими компонентами даты.
MonthAsString(Int32)	Возвращает строковое представление месяца, подходящего для включения с другими компонентами даты.
NanosecondAsPaddedString(Int32)	Возвращает строковое представление наносекунд, при необходимости с нулевой заполнением.
NanosecondAsString()	Возвращает строку, содержащую числовое представление наносекунд.
PeriodAsString()	Возвращает строковое представление периода дня, например AM или PM, в котором используется наиболее распространенное сокращение.
PeriodAsString(Int32)	Возвращает строковое представление периода дня, например AM или PM.
SecondAsPaddedString(Int32)	Возвращает строковое представление второго , при необходимости с нулевой заполнением.
SecondAsString()	Возвращает строку, содержащую числовое представление секунды.
SetDateTime(DateTime)	Задает для всех полей даты и времени дату и время, представленные параметром DateTime .
SetToMax()	Задает для компонентов этого объекта Calendar последнюю поддерживаемую версию DateTime .
SetToMin()	Устанавливает для компонентов этого объекта Calendar самые ранние поддерживаемые значения DateTime .
SetToNow()	Задает для компонентов этого объекта Calendar текущее значение DateTime.
TimeZoneAsString()	Возвращает полное имя часового пояса, применимое к моменту времени, которое представляет данный объект Calendar .
TimeZoneAsString(Int32)	Возвращает сокращенное имя часового пояса, применимое к моменту времени, которое представляет данный объект Calendar .
YearAsPaddedString(Int32)	Возвращает строковое представление года, при необходимости заполненное нулевым значением.
YearAsString()	Возвращает строковое представление года без начального заполнения нулевым значением.
YearAsTruncatedString(Int32)	Возвращает строковое представление года, при необходимости усеченное.

См. также раздел

• Элементы управления календарем, датой и временем
• Пример календаря
• Пример форматирования даты и времени
• Пример предпочтений глобализации (Windows 10)
• Подготовка приложения к изменению японского летосчисления