Calendar Classe

Definição

Namespace:

Windows.Globalization

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

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

Herança

Object Platform::Object IInspectable Calendar

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Confira também

• Controles de calendário, data e hora
• Amostra de calendário
• Exemplo de formatação de data e hora
• Exemplo de preferências de globalização (Windows 10)
• Prepare seu aplicativo para a mudança de era japonesa