SimpleDateFormat Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
SimpleDateFormat é uma classe concreta para formatação e análise de datas de maneira sensível à localidade.
[Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)]
public class SimpleDateFormat : Java.Text.DateFormat[<Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)>]
type SimpleDateFormat = class
inherit DateFormat- Herança
- Atributos
Comentários
SimpleDateFormat é uma classe concreta para formatação e análise de datas de maneira sensível à localidade. Ele permite formatação (texto de data →), análise (data > de texto) e normalização.
SimpleDateFormat permite que você comece escolhendo quaisquer padrões definidos pelo usuário para formatação de data e hora. No entanto, você é incentivado a criar um formatador de data/hora com getTimeInstance, getDateInstanceou getDateTimeInstance em DateFormat. Cada um desses métodos de classe pode retornar um formatador de data/hora inicializado com um padrão de formato padrão. Você pode modificar o padrão de formato usando os applyPattern métodos conforme desejado. Para obter mais informações sobre como usar esses métodos, consulte DateFormat.
<Padrões> de data e hora h2</h2>
Os formatos de data e hora são especificados por <cadeias de>caracteres padrão</em> data e hora. Dentro de cadeias de caracteres de padrão de data e hora, as letras não coqueadas de 'A''Z' e para 'a' para 'z' são interpretadas como letras padrão que representam os componentes de uma cadeia de caracteres de data ou hora. O texto pode ser citado usando aspas simples (') para evitar a interpretação.
"''" representa uma única aspa. Todos os outros caracteres não são interpretados; eles são simplesmente copiados para a cadeia de caracteres de saída durante a formatação ou correspondentes com a cadeia de caracteres de entrada durante a análise.
As seguintes letras padrão são definidas (todos os outros caracteres de e para onde são reservados): 'A'classe de tabela blockquote'Z''a'="striped"'z'<caption style="display:none">Gráfico mostra letras padrão, componente de data/hora, apresentação e exemplos.<><></caption>thead<>tr<>th scope="col" style="text-align:left"<Letter >th scope="col" style="text-align:left"<Date or Time Component >th scope="col" style="text-align:left"<Presentation >th scope="col" style="text-align:left"<Examples >th scope="col" style="text-align:left"<Supported (API Levels) >/thead<>tbody<>tr<>th scope="row"<>Gtd Era<> designator <td>Text<td>AD<td>1+</td><tr><th scope="row">y<td>Year <td>Year<td;>199696<td>1+</td><tr><th scope="row">Y<td>Week year <td>Year<td;>200909<td>24+</td><tr><th scope="row">M<td>Month in year (context sensitive) <td>Month<td>July; ; Jul07<td>1+</td><tr><th scope="row">L<td>Mês no ano (formulário autônomo) <td>Mês<td>July; ; Jul07<td>TBD</td><tr><th scope="row">w<td>Week in year <td>number<td td>27<>1+</td><tr><th scope="row">W<td>Week in month <td>Number<td td>2<>1+</td><tr><th scope="row">D<td>Day in year <td>Number<td>189<td>1+</td><tr><th scope="row">d<td>Day in month <td>Number<td td>10<>1+</td><tr><th scope="row">F<td>Day of week in month <td>Number<td td td>2<>1+</td><tr><th scope="row">E<td>Day name in week <td Text><td>Tuesday; Tue<td>1+</td><tr><th scope="row">u<td>Número de dia da semana (1 = segunda-feira, ..., 7 = domingo) <td>Número<td td>1<>24+</td><tr><th scope="row">a<td>Am/pm marker <td>Text<td td>PM<>1+</td><tr><th scope="row">H<td>Hora no dia (0-23) td Número td td<><td>1+0/td<>tr<>th scope="row"<><td>Hour in day (1-24) ktd<Number>td td td<><>1+24/td<>tr<>th scope="row"<><td>Hour in am/pm (0-11) Ktd<Number>td td<><>1+0/td<>tr<>th scope=<><"row">h<td>Hour in am/pm (1-12) <td Number>td<td td>12<>1+</td><tr><th scope="row">m<td>Minute in hour <td>Number<td td>30<>1+</td><tr><th scope="row">s<td>Second in minute <td>Number<td td>55<>1+</td><tr><th scope="row">S<td>Milissegundo <td>Number<td td>978<>1+</td><tr><th scope="row">z<td>Time zone <td>General time zone<td>Pacific Standard Time; ; PSTGMT-08:00<td>1+</td><tr><th scope="row">Z<td>Time zone <td>RFC 822 time zone<td td>-0800<>1+</td><tr><th scope="row">X<td>Time zone <td>ISO 8601 time zone<td>-08; ; -0800-08:00<td>24+</td></tbody></table></blockquote> As letras padrão geralmente são repetidas, pois seu número determina a apresentação exata: <ul><li><strong>"text">Text:</strong> For formatting, if the number of pattern letters is 4 or more, the full form is used; otherwise a short or abbreviated form is used if available. Para análise, ambos os formulários são aceitos, independentemente do número de letras padrão.</li li><><strong>"number">Number:</strong> For formatting, the number of pattern letters is the minimum number of digits, and shorter numbers are zero-padded to this amount. Para análise, o número de letras padrão é ignorado, a menos que seja necessário separar dois campos adjacentes.</li li><><strong>"year">Year:</strong> If the formatter's #getCalendar() Calendar is the Gregorian calendar, the following rules are applied.
<ul><li>Para formatação, se o número de letras padrão for 2, o ano será truncado para dois dígitos; caso contrário, ele será interpretado como um número.
<li>Para análise, se o número de letras padrão for maior que 2, o ano será interpretado literalmente, independentemente do número de dígitos. Portanto, usando o padrão "MM/dd/yyyyy", "01/11/12" analisa para 11 de janeiro de 12 d.D. <li>Para analisar com o padrão de ano abreviado ("y" ou "yy"), SimpleDateFormat deve interpretar o ano abreviado em relação a algum século. Ele faz isso ajustando as datas para dentro de 80 anos antes e 20 anos após o momento em que a SimpleDateFormat instância é criada. Por exemplo, usando um padrão de "MM/dd/yy" e uma SimpleDateFormat instância criada em 1º de janeiro de 1997, a cadeia de caracteres "01/11/12" seria interpretada como 11 de janeiro de 2012, enquanto a cadeia de caracteres "05/04/64" seria interpretada como 4 de maio de 1964. Durante a análise, somente cadeias de caracteres que consistem em exatamente dois dígitos, conforme definido por Character#isDigit(char), serão analisadas no século padrão. Qualquer outra cadeia de caracteres numérica, como uma cadeia de caracteres de um dígito, uma cadeia de caracteres de três ou mais dígitos ou uma cadeia de caracteres de dois dígitos que não seja todos dígitos (por exemplo, "-1"), é interpretada literalmente. Portanto, "01/02/3" ou "01/02/003" são analisados, usando o mesmo padrão, como 2 de janeiro de 3 AD. Da mesma forma, "01/02/-3" é analisado como 2 de janeiro, 4 a.C.
</ul> Caso contrário, formulários específicos do sistema de calendário são aplicados. Para formatação e análise, se o número de letras padrão for 4 ou mais, um formulário longo Calendar#LONG específico do calendário será usado. Caso contrário, um formulário específico de calendário#SHORT curto ou abreviado será usado.
<br> Se o ano 'Y' da semana for especificado e o calendário #getCalendar() não oferecer suporte a nenhum ano de semana, o ano civil ('y') será usado em vez disso. O suporte de anos semanais pode ser testado com uma chamada para DateFormat#getCalendar() getCalendar().java.util.Calendar#isWeekDateSupported() isWeekDateSupported().</li li><><strong>"month">Month:</strong> If the number of pattern letters is 3 or more, the month is interpreted as text; otherwise, it is interpreted as a number.
<ul><li>Letter <em>M</em> produz nomes de mês sensíveis ao contexto, como a forma inserida de nomes. A letra <em>M</em> diferencia o contexto no sentido de que, quando é usada no padrão autônomo, por exemplo, "MMMM", ela fornece a forma autônoma de um nome de mês e quando é usada no padrão que contém outros campos, por exemplo, "d MMMM", fornece o formato de formato de um nome de mês. Por exemplo, janeiro na língua catalã é "de gener" na forma de formato enquanto é "gener" na forma autônoma. Nesse caso, "MMMM" produzirá "gener" e a parte do mês do "d MMMM" produzirá "de gener". Se um DateFormatSymbols tiver sido definido explicitamente com o construtor #SimpleDateFormat(String,DateFormatSymbols) ou o método#setDateFormatSymbols(DateFormatSymbols), os nomes de mês dados por eles DateFormatSymbols serão usados.</li li><>Letter <em>L</em> produz a forma autônoma de nomes de mês.</li></ul><br></li li><><strong>"timezone">Fuso horário geral:</fusos horários fortes> são interpretados como texto se tiverem nomes. Para fusos horários que representam um valor de deslocamento GMT, a seguinte sintaxe é usada:
<a id="GMTOffsetTimeZone"><i>GMTOffsetTimeZone:</i></a>
{@code GMT} <i>Sign</i> <i>Hours</i> {@code :} <i>Minutes</i>
<i>Sign:</i> one of
{@code + -}
<i>Hours:</i>
<i>Digit</i>
<i>Digit</i> <i>Digit</i>
<i>Minutes:</i>
<i>Digit</i> <i>Digit</i>
<i>Digit:</i> one of
{@code 0 1 2 3 4 5 6 7 8 9}
As horas devem estar entre 0 e 23, e minutos devem estar entre 00 e 59. O formato é independente de localidade e os dígitos devem ser retirados do bloco latino básico do padrão Unicode.
Para análise, os fusos horários RFC 822 também são aceitos.</li><li><strong>"rfc822timezone">Fuso horário RFC 822:</strong> Para formatação, o formato de fuso horário RFC 822 de 4 dígitos é usado:
<i>RFC822TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
<i>TwoDigitHours:</i>
<i>Digit Digit</i>
TwoDigitHours deve estar entre 00 e 23. Outras definições são quanto a fusos horários gerais.
Para análise, fusos horários gerais também são aceitos. <li><strong>"iso8601timezone">ISO 8601 Fuso horário:</strong> O número de letras padrão designa o formato para formatação e análise da seguinte maneira:
<i>ISO8601TimeZone:</i>
<i>OneLetterISO8601TimeZone</i>
<i>TwoLetterISO8601TimeZone</i>
<i>ThreeLetterISO8601TimeZone</i>
<i>OneLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i>
{@code Z}
<i>TwoLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
{@code Z}
<i>ThreeLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> {@code :} <i>Minutes</i>
{@code Z}
Outras definições são para fusos horários gerais ou fusos horários RFC 822.
Para formatação, se o valor de deslocamento de GMT for 0, "Z" será produzido. Se o número de letras padrão for 1, qualquer fração de hora será ignorada. Por exemplo, se o padrão for "X" e o fuso horário for "GMT+05:30", "+05" será produzido.
Para análise, a letra "Z" é analisada como o designador de fuso horário UTC (portanto, "09:30Z" é analisada como "09:30 UTC". Fusos horários gerais não< são ><aceitos.>
Se o número de "X" letras padrão for 4 ou mais (por exemplo XXXX), IllegalArgumentException será gerado ao construir um SimpleDateFormat ou #applyPattern(String) aplicando um padrão.
</ul>SimpleDateFormat também dá suporte a cadeias de caracteres <>de padrão</em> de data e hora localizadas. Nessas cadeias de caracteres, as letras padrão descritas acima podem ser substituídas por outras letras padrão dependentes de localidade.
SimpleDateFormat não lida com a localização de texto diferente das letras padrão; isso é com o cliente da classe.
<Exemplos> de h3</h3>
Os exemplos a seguir mostram como os padrões de data e hora são interpretados na localidade dos EUA. A data e hora fornecidas são 2001-07-04 12:08:56 hora local no fuso horário do Pacífico dos EUA.
<classe de tabela blockquote="striped"><caption style="display:none">Exemplos de padrões de data e hora interpretados na localidade</legenda><dos EUA thead><tr><th scope="col" style="text-align:left">Date and Time Pattern <th scope="col" style="text-align:left">Result </thead><tbody><tr><th scope="row"><>td"yyyy.MM.dd G 'at' HH:mm:ss z"<>tr2001.07.04 AD at 12:08:56 PDT<th scope="row"><>"EEE, MMM d, ''yy"<td>Wed, Jul 4, '01<tr><th scope="row">"h:mm a"<td>12:08 PM<tr><th scope="row">"hh 'o''clock' a, zzzz"<td>12 o'clock PM, Pacific Daylight Time<tr><th scope="row">"K:mm a, z"<td>0:08 PM, PDT<tr><th scope="row">"yyyyy.MMMMM.dd GGG hh:mm aaa"<td>02001.July.04 AD 12:08 PM<tr><th scope="row">"EEE, d MMM yyyy HH:mm:ss Z"<td>Wed, 4 Jul 2001 12:08:56 -0700<tr><th scope="row">"yyMMddHHmmssZ"<td>010704120856-0700<tr><th scope="row">"yyyy-MM-dd'T'HH:mm:ss.SSSZ"<td>2001-07-04T12:08:56.235-0700<tr><th scope="row">"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"<td>2001-07-04T12:08:56.235-07:00<tr><th scope="row">"YYYY-'W'ww-u"<td>2001-W27-3</tbody></table></blockquote>
<h3>"synchronization">Synchronization</h3>
Os formatos de data não são sincronizados. É recomendável criar instâncias de formato separadas para cada thread. Se vários threads acessarem um formato simultaneamente, ele deverá ser sincronizado externamente.
Adicionado em 1.1.
Java documentação para java.text.SimpleDateFormat.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Construtores
| Nome | Description |
|---|---|
| SimpleDateFormat() |
Constrói um |
| SimpleDateFormat(IntPtr, JniHandleOwnership) |
Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime. |
| SimpleDateFormat(String, DateFormatSymbols) |
Constrói um |
| SimpleDateFormat(String, Locale) |
Constrói um |
| SimpleDateFormat(String) |
Constrói um |
Campos
| Nome | Description |
|---|---|
| AmPmField |
Constante útil para AM_PM alinhamento de campo. (Herdado de DateFormat) |
| DateField |
Constante útil para alinhamento de campo DATE. (Herdado de DateFormat) |
| DayOfWeekField |
Constante útil para DAY_OF_WEEK alinhamento de campo. (Herdado de DateFormat) |
| DayOfWeekInMonthField |
Constante útil para DAY_OF_WEEK_IN_MONTH alinhamento de campo. (Herdado de DateFormat) |
| DayOfYearField |
Constante útil para DAY_OF_YEAR alinhamento de campo. (Herdado de DateFormat) |
| Default |
Constante para padrão de estilo padrão. (Herdado de DateFormat) |
| EraField |
Constante útil para alinhamento de campo ERA. (Herdado de DateFormat) |
| Full |
Constante para padrão de estilo completo. (Herdado de DateFormat) |
| Hour0Field |
Constante útil para alinhamento de campo HOUR baseado em zero. (Herdado de DateFormat) |
| Hour1Field |
Constante útil para alinhamento de campo HOUR baseado em um. (Herdado de DateFormat) |
| HourOfDay0Field |
Constante útil para alinhamento de campo de HOUR_OF_DAY baseado em zero. (Herdado de DateFormat) |
| HourOfDay1Field |
Constante útil para alinhamento de campo de HOUR_OF_DAY baseado. (Herdado de DateFormat) |
| Long |
Constante para um padrão de estilo longo. (Herdado de DateFormat) |
| Medium |
Constante para padrão de estilo médio. (Herdado de DateFormat) |
| MillisecondField |
Constante útil para o alinhamento do campo MILLISECOND. (Herdado de DateFormat) |
| MinuteField |
Constante útil para alinhamento de campo MINUTE. (Herdado de DateFormat) |
| MonthField |
Constante útil para alinhamento de campo MONTH. (Herdado de DateFormat) |
| SecondField |
Constante útil para alinhamento de campo SECOND. (Herdado de DateFormat) |
| Short |
Constante para um padrão de estilo curto. (Herdado de DateFormat) |
| TimezoneField |
Constante útil para alinhamento de campo TIMEZONE. (Herdado de DateFormat) |
| WeekOfMonthField |
Constante útil para WEEK_OF_MONTH alinhamento de campo. (Herdado de DateFormat) |
| WeekOfYearField |
Constante útil para WEEK_OF_YEAR alinhamento de campo. (Herdado de DateFormat) |
| YearField |
Constante útil para alinhamento de campo YEAR. (Herdado de DateFormat) |
Propriedades
| Nome | Description |
|---|---|
| Calendar |
Obtém o calendário associado a esse formatador de data/hora. -ou- Defina o calendário a ser usado por este formato de data. (Herdado de DateFormat) |
| Class |
Retorna a classe de runtime deste |
| DateFormatSymbols |
Obtém uma cópia dos símbolos de formato de data e hora desse formato de data. -ou- Define os símbolos de formato de data e hora desse formato de data. |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniPeerMembers |
|
| Lenient |
Informe se a análise de data/hora deve ser branda. -ou- Especifique se a análise de data/hora deve ou não ser branda. (Herdado de DateFormat) |
| NumberFormat |
Obtém o formatador de número que esse formatador de data/hora usa para formatar e analisar uma hora. -ou- Permite que você defina o formatador de números. (Herdado de DateFormat) |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| ThresholdClass |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| ThresholdType |
Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código. |
| TimeZone |
Obtém o fuso horário. -ou- Define o fuso horário para o calendário deste |
Métodos
| Nome | Description |
|---|---|
| ApplyLocalizedPattern(String) |
Aplica a cadeia de caracteres de padrão localizada fornecida a esse formato de data. |
| ApplyPattern(String) |
Aplica a cadeia de caracteres de padrão fornecida a este formato de data. |
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de _Format) |
| Dispose() |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Dispose(Boolean) |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| Format(Date, StringBuffer, FieldPosition) |
Formata o dado |
| Format(Date) |
Formata um em |
| Format(Object, StringBuffer, FieldPosition) |
Formata o dado |
| Format(Object) |
Formata um objeto para produzir uma cadeia de caracteres. (Herdado de _Format) |
| FormatToCharacterIterator(Object) |
Formata um objeto que produz um |
| Get2DigitYearStart() |
Retorna a data de início dos anos de 2 dígitos do período de 100 anos que são interpretados como sendo dentro. |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| JavaFinalize() |
Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object) |
| Notify() |
Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object) |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| Parse(String, ParsePosition) |
Analisa o texto de uma cadeia de caracteres para produzir um |
| Parse(String) |
Analisa o texto desde o início da cadeia de caracteres fornecida para produzir uma data. (Herdado de DateFormat) |
| ParseObject(String, ParsePosition) |
Analisa o texto de uma cadeia de caracteres para produzir um |
| ParseObject(String) |
Analisa o texto desde o início da cadeia de caracteres fornecida para produzir um objeto. (Herdado de _Format) |
| Set2DigitYearStart(Date) |
Define que os anos de 2 dígitos do período de 100 anos serão interpretados como sendo iniciados na data especificada pelo usuário. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToLocalizedPattern() |
Retorna uma cadeia de caracteres de padrão localizada que descreve esse formato de data. |
| ToPattern() |
Retorna uma cadeia de caracteres padrão que descreve esse formato de data. |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IJavaPeerable.Disposed() |
Notifica o runtime de interoperabilidade de que esse par gerenciado foi descartado. (Herdado de Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Libera esse par Java, a menos que seja mantido por outra referência gerenciada. (Herdado de Object) |
| IJavaPeerable.Finalized() |
Notifica o runtime de interoperabilidade de que esse par gerenciado foi finalizado. (Herdado de Object) |
| IJavaPeerable.JniManagedPeerState |
Obtém o estado que descreve a relação entre esse par gerenciado e sua referência de JNI. (Herdado de Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Define o código de hash de identidade de interoperabilidade para esse par Java. (Herdado de Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Define o estado de par gerenciado e JNI para esse par Java. (Herdado de Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Define a referência de objeto JNI usada por esse par gerenciado. (Herdado de Object) |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |