Partilhar via


Calendar Classe

Definição

Manipula a representação de um DateTime em um determinado calendário e relógio.

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
Herança
Object Platform::Object IInspectable Calendar
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Se seu aplicativo passar marcas de idioma usadas nessa classe para qualquer função de Suporte à Linguagem Nacional , ele deverá primeiro converter as marcas chamando ResolveLocaleName.

As marcas de linguagem dão suporte às extensões Unicode "ca-" e "nu-". (Consulte Definições de chave/tipo Unicode.) Observe que essas extensões podem afetar o calendário usado pelos objetos Calendar.

Construtores

Calendar()

Cria um objeto Calendar e o inicializa para o DateTime atual.

Calendar(IIterable<String>)

Cria um objeto Calendar que é inicializado com uma lista de idiomas.

Calendar(IIterable<String>, String, String)

Cria um objeto Calendar que é inicializado com uma lista de idiomas, calendário e relógio.

Calendar(IIterable<String>, String, String, String)

Cria um objeto Calendar que é inicializado com uma lista de idiomas, calendário, relógio e fuso horário.

Propriedades

Day

Obtém ou define o dia.

DayOfWeek

Obtém o dia da semana.

Era

Obtém ou define a era.

FirstDayInThisMonth

Obtém o primeiro Dia do Mês atual.

FirstEra

Obtém a primeira Era disponível no calendário.

FirstHourInThisPeriod

Obtém a primeira hora do período atual.

FirstMinuteInThisHour

Obtém o primeiro minuto da hora atual.

FirstMonthInThisYear

Obtém o primeiro mês do ano atual.

FirstPeriodInThisDay

Obtém o primeiro Período do Dia atual.

FirstSecondInThisMinute

Obtém o primeiro Segundo do Minuto atual.

FirstYearInThisEra

Obtém o primeiro Ano da Era atual.

Hour

Obtém ou define a hora.

IsDaylightSavingTime

Obtém um booliano que indica se o Horário de Verão está em vigor para a data deste objeto Calendar .

Languages

Obtém a lista de prioridades de identificadores de idioma usados ao formatar componentes como cadeias de caracteres.

LastDayInThisMonth

Obtém o último dia do mês atual.

LastEra

Obtém a última Era disponível no calendário.

LastHourInThisPeriod

Obtém a última hora do período atual.

LastMinuteInThisHour

Obtém o último minuto da hora atual.

LastMonthInThisYear

Obtém o último mês do ano atual.

LastPeriodInThisDay

Obtém o último Período do Dia atual.

LastSecondInThisMinute

Obtém o último Segundo do Minuto atual.

LastYearInThisEra

Obtém o último ano da era atual.

Minute

Obtém ou define o minuto.

Month

Obtém ou define o mês.

Nanosecond

Obtém ou define o nanossegundo.

NumberOfDaysInThisMonth

Obtém o número de dias no mês atual deste objeto Calendar .

NumberOfEras

Obtém o número de eras neste objeto Calendar .

NumberOfHoursInThisPeriod

Obtém o número de horas no período do dia atual deste objeto Calendar .

NumberOfMinutesInThisHour

Obtém o número de Minutosna Hora atual.

NumberOfMonthsInThisYear

Obtém o número de meses no ano atual deste objeto Calendar .

NumberOfPeriodsInThisDay

Obtém o número de períodos no dia atual deste objeto Calendar .

NumberOfSecondsInThisMinute

Obtém o número de Segundoss no Minuto atual.

NumberOfYearsInThisEra

Obtém o número de anos na era atual deste objeto Calendar .

NumeralSystem

Obtém ou define o sistema de numeração usado ao formatar componentes como cadeias de caracteres.

Period

Obtém ou define o período do dia atual.

ResolvedLanguage

Obtém o idioma usado mais recentemente para executar operações ou formatação de calendário.

Second

Obtém ou define o segundo.

Year

Obtém ou define o ano.

Métodos

AddDays(Int32)

Incrementa ou diminui o dia.

AddEras(Int32)

Incrementa ou diminui a era.

AddHours(Int32)

Incrementa ou diminui a hora.

AddMinutes(Int32)

Incrementa ou diminui o minuto.

AddMonths(Int32)

Incrementa ou diminui o mês.

AddNanoseconds(Int32)

Incrementa ou diminui o nanossegundo.

AddPeriods(Int32)

Incrementa ou diminui o período.

AddSeconds(Int32)

Incrementa ou diminui o segundo.

AddWeeks(Int32)

Incrementa ou diminui o dia pelo número especificado de semanas.

AddYears(Int32)

Incrementa ou diminui o ano.

ChangeCalendarSystem(String)

Define um novo sistema de calendário a ser usado por este objeto Calendar .

ChangeClock(String)

Define um novo relógio a ser usado por este objeto Calendar .

ChangeTimeZone(String)

Define um novo fuso horário a ser usado por este objeto Calendar .

Clone()

Cria uma cópia do objeto Calendar .

Compare(Calendar)

Compara esse calendário com outro objeto Calendar e indica se o DateTime de um é anterior, igual ou posterior ao do outro.

CompareDateTime(DateTime)

Compara esse calendário a um objeto DateTime e indica se a data e a hora de um é anterior, igual ou posterior à do outro.

CopyTo(Calendar)

Copia os valores de outro objeto Calendar para este Calendário.

DayAsPaddedString(Int32)

Retorna uma representação de cadeia de caracteres do dia, opcionalmente sem adição de zero.

DayAsString()

Retorna uma cadeia de caracteres que contém a representação numérica do dia.

DayOfWeekAsSoloString()

Retorna uma representação de cadeia de caracteres do dia da semana adequada para exibição autônoma.

DayOfWeekAsSoloString(Int32)

Retorna uma representação de cadeia de caracteres do dia da semana adequada para exibição autônoma.

DayOfWeekAsString()

Retorna uma representação de cadeia de caracteres do dia da semana adequada para inclusão com outros componentes de data.

DayOfWeekAsString(Int32)

Retorna uma representação de cadeia de caracteres do dia da semana adequada para inclusão com outros componentes de data.

EraAsString()

Retorna uma representação de cadeia de caracteres da era.

EraAsString(Int32)

Retorna uma representação de cadeia de caracteres da era. A cadeia de caracteres escolhida é mais próxima do comprimento ideal.

GetCalendarSystem()

Obtém o sistema de calendário usado por este objeto Calendar .

GetClock()

Obtém o relógio usado por este objeto Calendar .

GetDateTime()

Cria uma data e hora, considerando os componentes deste objeto Calendar .

GetTimeZone()

Obtém o identificador que identifica o fuso horário usado por esse objeto Calendar .

HourAsPaddedString(Int32)

Retorna uma representação de cadeia de caracteres da hora, opcionalmente sem adição de zero.

HourAsString()

Retorna uma cadeia de caracteres que contém a representação numérica da hora.

MinuteAsPaddedString(Int32)

Retorna uma representação de cadeia de caracteres do minuto, opcionalmente sem adição de zero.

MinuteAsString()

Retorna uma cadeia de caracteres que contém a representação numérica do minuto.

MonthAsNumericString()

Retorna uma cadeia de caracteres que contém a representação numérica do mês.

MonthAsPaddedNumericString(Int32)

Retorna uma representação de cadeia de caracteres do mês, opcionalmente sem adição de zero.

MonthAsSoloString()

Retorna uma representação de cadeia de caracteres do mês adequada para exibição autônoma.

MonthAsSoloString(Int32)

Retorna uma representação de cadeia de caracteres do mês adequada para exibição autônoma.

MonthAsString()

Retorna uma representação de cadeia de caracteres do mês adequada para inclusão com outros componentes de data.

MonthAsString(Int32)

Retorna uma representação de cadeia de caracteres do mês adequada para inclusão com outros componentes de data.

NanosecondAsPaddedString(Int32)

Retorna uma representação de cadeia de caracteres do nanossegundo, opcionalmente sem adição de zero.

NanosecondAsString()

Retorna uma cadeia de caracteres que contém a representação numérica do nanossegundo.

PeriodAsString()

Retorna uma representação de cadeia de caracteres do período do dia, como AM ou PM, que usa a abreviação mais comum disponível.

PeriodAsString(Int32)

Retorna uma representação de cadeia de caracteres do período do dia, como AM ou PM.

SecondAsPaddedString(Int32)

Retorna uma representação de cadeia de caracteres do segundo, opcionalmente sem adição de zero.

SecondAsString()

Retorna uma cadeia de caracteres que contém a representação numérica do segundo.

SetDateTime(DateTime)

Define todos os campos de data e hora como a data e hora representadas pelo parâmetro DateTime .

SetToMax()

Define os componentes desse objeto Calendar como o DateTime mais recente com suporte.

SetToMin()

Define os componentes desse objeto Calendar como o datetime mais antigo com suporte.

SetToNow()

Define os componentes desse objeto Calendar para o DateTime atual.

TimeZoneAsString()

Retorna o nome de fuso horário completo aplicável no instante em que esse objeto Calendar representa.

TimeZoneAsString(Int32)

Retorna o nome abreviado de fuso horário aplicável no instante em que esse objeto Calendar representa.

YearAsPaddedString(Int32)

Retorna uma representação de cadeia de caracteres do ano, opcionalmente sem adição de zero.

YearAsString()

Retorna uma representação de cadeia de caracteres do ano sem nenhum preenchimento zero inicial.

YearAsTruncatedString(Int32)

Retorna uma representação de cadeia de caracteres do ano, opcionalmente truncada.

Aplica-se a

Confira também