Calendar Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет представлением даты и времени в пределах заданного календаря и часов.
public ref class Calendar sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ICalendarFactory2, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ICalendarFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class Calendar final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ICalendarFactory2), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ICalendarFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class Calendar
[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
- Наследование
- Атрибуты
Требования к 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) |
Возвращает строковое представление года, при необходимости усеченное. |