Clase DateTimeFormatter

DateTimeFormatter Class

Da formato a las fechas y horas.

Sintaxis


var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(string);
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(string, iIterable(String));
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(string, iIterable(String));
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat);
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(hourFormat, minuteFormat, secondFormat);
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat, hourFormat, minuteFormat, secondFormat, iIterable(String));
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat, hourFormat, minuteFormat, secondFormat, iIterable(String));

Atributos

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Members

A continuación se indican los tipos de miembros de DateTimeFormatter (Clase):

Constructores

A continuación se indican los constructores de DateTimeFormatter (Clase).

ConstructorDescripción
DateTimeFormatter(HourFormat, MinuteFormat, SecondFormat) Creates a DateTimeFormatter object that is initialized with hour, minute, and second formats.
DateTimeFormatter(String) Creates a DateTimeFormatter object that is initialized by a format template string.
DateTimeFormatter(String, IIterable(String)) Creates a DateTimeFormatter object that is initialized by a format template string and language list.
DateTimeFormatter(String, IIterable(String), String, String, String) Creates a DateTimeFormatter object that is initialized by a format template string, language list, geographic region, calendar, and clock.
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat) Creates a DateTimeFormatter object that is initialized with year, month, day, and day of week formats.
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable(String)) Creates a DateTimeFormatter object that is initialized with year, month, day, day of week, hour, minute, and second formats, and a language list.
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable(String), String, String, String) Creates a DateTimeFormatter object with all formats and identifiers specified.

 

Métodos

The DateTimeFormatter Clase tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

MétodoDescripción
Format(DateTime) Returns a string representation of the provided date and time.
Format(DateTime, String) Returns a string that represents the given date and time in the given time zone, conforming to the template the formatter is currently using.

 

Propiedades

DateTimeFormatterClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

Calendar

De sólo lecturaGets the calendar that is used when formatting dates.

Clock

De sólo lecturaGets the clock that is used when formatting times.

GeographicRegion

De sólo lecturaGets or sets the region that is used when formatting dates and times.

IncludeDay

De sólo lecturaGets the DayFormat in the template.

IncludeDayOfWeek

De sólo lecturaGets the DayOfWeekFormat in the template.

IncludeHour

De sólo lecturaGets the HourFormat in the template.

IncludeMinute

De sólo lecturaGets the MinuteFormat in the template.

IncludeMonth

De sólo lecturaGets the MonthFormat in the template.

IncludeSecond

De sólo lecturaGets the SecondFormat in the template.

IncludeYear

De sólo lecturaGets the YearFormat in the template.

Languages

De sólo lecturaGets the priority list of language identifiers that is used when formatting dates and times.

LongDate

De sólo lecturaGets the DateTimeFormatter object that formats dates according to the user's choice of long date pattern.

LongTime

De sólo lecturaGets the DateTimeFormatter object that formats times according to the user's choice of long time pattern.

NumeralSystem

Lectura/escrituraGets or sets the numbering system that is used to format dates and times.

Patterns

De sólo lecturaGets the patterns corresponding to this template that are used when formatting dates and times.

ResolvedGeographicRegion

De sólo lecturaGets the geographic region that was most recently used to format dates and times.

ResolvedLanguage

De sólo lecturaGets the language that was most recently used to format dates and times.

ShortDate

De sólo lecturaGets the DateTimeFormatter object that formats dates according to the user's choice of short date pattern.

ShortTime

De sólo lecturaGets the DateTimeFormatter object that formats times according to the user's choice of short time pattern.

Template

De sólo lecturaGets a string representation of this format template.

 

Comentarios

Nota  Si la aplicación pasa etiquetas de idioma usadas en esta clase a cualquier función de compatibilidad con el idioma nacional, primero debe convertir las etiquetas llamando a ResolveLocaleName.

Algunos de los constructores de DateTimeFormatter toman un parámetro de cadena formatTemplate que especifica los componentes solicitados a los que se va a dar formato. Este parámetro puede ser una plantilla de formato o un patrón de formato.

Las plantillas de formato son cadenas que especifican patrones de fecha y hora comunes. Algunas plantillas de uso general se incluyen en la tabla siguiente. En plantillas con más de un componente, el componente puede ser cualquiera de las variaciones de componentes admitidas y los componentes pueden estar en cualquier orden. Por ejemplo, se admite "dayofweek.full year month.numeric day". (Vea abajo, después de los ejemplos, para consultar la gramática que define plantillas válidas).

Plantilla
longdate
shortdate
longtime
shorttime
dayofweek
dayofweek.full
dayofweek.abbreviated
day
month
month.full
month.abbreviated
month.numeric
año
year.full
year.abbreviated
dayofweek day month year
dayofweek día mes
day month year
day month
month year
hour
minute
second
hour minute second
hour minute
timezone
timezone.full
timezone.abbreviated
año mes día hora

 

Los patrones de formato están compuestos de una cadena literal con campos delimitados por llaves, como "{day.numeric}/{month.numeric}/{year.full}". Algunos campos de uso general se incluyen en la tabla siguiente. (Vea abajo, después de los ejemplos, para consultar la gramática que define patrones válidos).

Campo Patrón de formato
{openbrace}
{closebrace}
{dayofweek.solo.<type>} donde <type> es full / abbreviated / abbreviated(n)
{dayofweek.<type>} donde <type> es full / abbreviated / abbreviated(n)
{day.<type>} donde <type> es integer / integer(n)
{month.<type>} donde <type> es full / abbreviated / abbreviated(n) / integer / integer(n)
{month.solo.<type>} donde <type> es full / abbreviated / abbreviated(n)
{year.<type>} donde <type> es full / abbreviated / abbreviated(n)
{era.<type>} donde <type> es full / abbreviated / abbreviated(n)
{hour.<type>} donde <type> es integer / integer(n)
{period.<type>} donde <type> es full / abbreviated / abbreviated(n)
{minute.<type>} donde <type> es integer / integer(n)
{second.<type>} donde <type> es integer / integer(n)
{timezone.<type>} donde <type> es full / abbreviated / abbreviated(n)

 

Nota  

  • Utilice {openbrace} o {closebrace} para especificar que "{" o "}" aparece como parte de la cadena literal.
  • solo especifica la forma independiente. Para lenguajes con distinciones de casos de genitivo, el caso de genitivo es el caso no marcado. Para obtener el caso nominativo, utilice solo.
  • integer(2) para el quinto día del mes (por ejemplo) es "05", mientras que integer(1) produce "5". integer genera el mejor n para una combinación dada de idioma/calendario.
  • Para años, full genera todos los dígitos ("2013"). abbreviated es sinónimo de abbreviated(2), que es el año de 2 dígitos para el calendario gregoriano ("13"). (Otros calendarios pueden utilizar finalmente algo más como valor predeterminado; hemos retenido abbreviated para tener la semántica mejor para una combinación de idioma/calendario). abbreviated(n) se trunca a los n dígitos menos significativos (por ejemplo, 2013 con n=1 es "3").

Ejemplos

Utilice la clase DateTimeFormatter para dar formato a una fecha.


// Format a date via a string template. Note that the order specifed in the string pattern does
// not determine the order of the parts of the formatted string. The user's language and region
// preferences will determine the pattern of the date returned based on the specified parts.

var mydatefmt = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("month day dayofweek year");
var dateToFormat = new Date();
var mydate = mydatefmt.format(dateToFormat);

Gramática de patrón

La gramática siguiente define qué se acepta como patrón:

<pattern> ::= [<literal-text>] <datetime-pattern> [<literal-text>] |
              [<literal-text>] <datetime-pattern> <pattern>

<literal-text> ::= <literal-character>+

<literal-character> ::= [^{}] | "{openbrace}" | "{closebrace}"

<datetime-pattern> ::= <date-pattern> | <time-pattern>

<date-pattern> ::= <era> | <year> | <month> | <day> | <dayofweek>

<time-pattern> ::= <period> | <hour> | <minute> | <second> | <timezone>

<era> ::= "{era.abbreviated" [<ideal-length>] "}"

<year> ::= "{year.full" [<ideal-length>] "}" |
           "{year.abbreviated" [<ideal-length>] "}"

<month> ::= "{month.full}" |
            "{month.solo.full}" |
            "{month.abbreviated" [<ideal-length>] "}"
            "{month.solo.abbreviated" [<ideal-length>] "}"
            "{month.integer" [<ideal-length>] "}"

<dayofweek> ::= "{dayofweek.full}" |
                "{dayofweek.solo.full}" |
                "{dayofweek.abbreviated" [<ideal-length>] "}"
                "{dayofweek.solo.abbreviated" [<ideal-length>] "}"

<day> ::= "{day.integer" [<ideal-length>] "}"

<period> ::= "{period.abbreviated" [<ideal-length>] "}"

<hour> ::= "{hour.integer" [<ideal-length>] "}"

<minute> ::= "{minute.integer" [<ideal-length>] "}"

<second> ::= "{second.integer" [<ideal-length>] "}"

<timezone> ::= "{timezone.full}" |
                "{timezone.abbreviated" [<ideal-length>] "}"

<ideal-length> ::= "(" <non-zero-digit> ")"

<non-zero-digit> ::= "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"

Gramática de plantilla

La gramática siguiente define qué se acepta como plantilla:

<template> ::= <opt-whitespace> <date> <opt-whitespace> |
               <opt-whitespace> <time> <opt-whitespace> |
               <opt-whitespace> <specific-date> <whitespace> <time> <opt-whitespace> |
               <opt-whitespace> <time> <whitespace> <specific-date> <opt-whitespace> |
               <opt-whitespace> <relative-date> <whitespace> <time> <opt-whitespace> |
               <opt-whitespace> <time> <whitespace> <relative-date> <opt-whitespace>

<opt-whitespace> ::= [<whitespace>] 

<whitespace> ::= " "+ 

<date> ::= <year> | <month> | <day> | <month-year> | <relative-date> | <specific-date>

<relativedate> ::= <dayofweek> | <month-day> | <relative-longdate>

<specificdate> ::= <shortdate> | <longdate>

<month-day> ::= <month> <whitespace> <day> |
                <day> <whitespace> <month>

<relative-longdate> ::= <month> <whitespace> <day> <whitespace> <dayofweek> |
                        <month> <whitespace> <dayofweek> <whitespace> <day> |
                        <day> <whitespace> <month> <whitespace> <dayofweek> |
                        <day> <whitespace> <dayofweek> <whitespace> <month> |
                        <dayofweek> <whitespace> <day> <whitespace> <month> |
                        <dayofweek> <whitespace> <month> <whitespace> <day>

<month-year> ::= <month> <whitespace> <year> |
                 <year> <whitespace> <month>


<shortdate> ::= "shortdate" |
                <month> <whitespace> <day> <whitespace> <year> |
                <month> <whitespace> <year> <whitespace> <day> |
                <day> <whitespace> <month> <whitespace> <year> |
                <day> <whitespace> <year> <whitespace> <month> |
                <year> <whitespace> <day> <whitespace> <month> |
                <year> <whitespace> <month> <whitespace> <day>


<longdate> ::= "longdate" |
               <year> <whitespace> <month> <whitespace> <day> <whitespace> <dayofweek> |
               <year> <whitespace> <month> <whitespace> <dayofweek> <whitespace> <day> |
               <year> <whitespace> <day> <whitespace> <month> <whitespace> <dayofweek> |
               <year> <whitespace> <day> <whitespace> <dayofweek> <whitespace> <month> |
               <year> <whitespace> <dayofweek> <whitespace> <day> <whitespace> <month> |
               <year> <whitespace> <dayofweek> <whitespace> <month> <whitespace> <day> |
               <month> <whitespace> <year> <whitespace> <day> <whitespace> <dayofweek> |
               <month> <whitespace> <year> <whitespace> <dayofweek> <whitespace> <day> |
               <day> <whitespace> <year> <whitespace> <month> <whitespace> <dayofweek> |
               <day> <whitespace> <year> <whitespace> <dayofweek> <whitespace> <month> |
               <dayofweek> <whitespace> <year> <whitespace> <day> <whitespace> <month> |
               <dayofweek> <whitespace> <year> <whitespace> <month> <whitespace> <day> |
               <month> <whitespace> <day> <whitespace> <year> <whitespace> <dayofweek> |
               <month> <whitespace> <dayofweek> <whitespace> <year> <whitespace> <day> |
               <day> <whitespace> <month> <whitespace> <year> <whitespace> <dayofweek> |
               <day> <whitespace> <dayofweek> <whitespace> <year> <whitespace> <month> |
               <dayofweek> <whitespace> <day> <whitespace> <year> <whitespace> <month> |
               <dayofweek> <whitespace> <month> <whitespace> <year> <whitespace> <day> |
               <month> <whitespace> <day> <whitespace> <dayofweek> <whitespace> <year> |
               <month> <whitespace> <dayofweek> <whitespace> <day> <whitespace> <year> |
               <day> <whitespace> <month> <whitespace> <dayofweek> <whitespace> <year> |
               <day> <whitespace> <dayofweek> <whitespace> <month> <whitespace> <year> |
               <dayofweek> <whitespace> <day> <whitespace> <month> <whitespace> <year> |
               <dayofweek> <whitespace> <month> <whitespace> <day> <whitespace> <year>

<time> ::= <hour> | 
           <hour> <whitespace> <timezone> |
           <timezone> <whitespace> <hour> |
           <shorttime> |
           <longtime>

<shorttime> ::= "shorttime" |
                <hour> <whitespace> <minute> |
                <minute> <whitespace> <hour> |
                <timezone> <whitespace> <hour> <whitespace> <minute> |
                <timezone> <whitespace> <minute> <whitespace> <hour> |
                <hour> <whitespace> <timezone> <whitespace> <minute> |
                <minute> <whitespace> <timezone> <whitespace> <hour> |
                <hour> <whitespace> <minute> <whitespace> <timezone> |
                <minute> <whitespace> <hour> <whitespace> <timezone>

<longtime> ::= "longtime" |
               <hour> <whitespace> <minute> <whitespace> <second> |
               <hour> <whitespace> <second> <whitespace> <minute> |
               <minute> <whitespace> <hour> <whitespace> <second> |
               <minute> <whitespace> <second> <whitespace> <hour> |
               <second> <whitespace> <minute> <whitespace> <hour> |
               <second> <whitespace> <hour> <whitespace> <minute> |
               <timezone> <whitespace> <hour> <whitespace> <minute> <whitespace> <second> |
               <timezone> <whitespace> <hour> <whitespace> <second> <whitespace> <minute> |
               <timezone> <whitespace> <minute> <whitespace> <hour> <whitespace> <second> |
               <timezone> <whitespace> <minute> <whitespace> <second> <whitespace> <hour> |
               <timezone> <whitespace> <second> <whitespace> <minute> <whitespace> <hour> |
               <timezone> <whitespace> <second> <whitespace> <hour> <whitespace> <minute> |
               <hour> <whitespace> <timezone> <whitespace> <minute> <whitespace> <second> |
               <hour> <whitespace> <timezone> <whitespace> <second> <whitespace> <minute> |
               <minute> <whitespace> <timezone> <whitespace> <hour> <whitespace> <second> |
               <minute> <whitespace> <timezone> <whitespace> <second> <whitespace> <hour> |
               <second> <whitespace> <timezone> <whitespace> <minute> <whitespace> <hour> |
               <second> <whitespace> <timezone> <whitespace> <hour> <whitespace> <minute> |
               <hour> <whitespace> <minute> <whitespace> <timezone> <whitespace> <second> |
               <hour> <whitespace> <second> <whitespace> <timezone> <whitespace> <minute> |
               <minute> <whitespace> <hour> <whitespace> <timezone> <whitespace> <second> |
               <minute> <whitespace> <second> <whitespace> <timezone> <whitespace> <hour> |
               <second> <whitespace> <minute> <whitespace> <timezone> <whitespace> <hour> |
               <second> <whitespace> <hour> <whitespace> <timezone> <whitespace> <minute> |
               <hour> <whitespace> <minute> <whitespace> <second> <whitespace> <timezone> |
               <hour> <whitespace> <second> <whitespace> <minute> <whitespace> <timezone> |
               <minute> <whitespace> <hour> <whitespace> <second> <whitespace> <timezone> |
               <minute> <whitespace> <second> <whitespace> <hour> <whitespace> <timezone> |
               <second> <whitespace> <minute> <whitespace> <hour> <whitespace> <timezone> |
               <second> <whitespace> <hour> <whitespace> <minute> <whitespace> <timezone>

<year> ::= "year" | "year.full" | "year.abbreviated"

<month> ::= "month" | "month.full" | "month.abbreviated" | "month.numeric"

<day> ::= "day"

<dayofweek> ::= "dayofweek" | "dayofweek.full" | "dayofweek.abbreviated"

<hour> ::= "hour"

<minute> ::= "minute"

<second> ::= "second"

<timezone> ::= "timezone" | "timezone.full" | "timezone.abbreviated"

Requisitos

Cliente mínimo admitido

Windows 8 [Aplicaciones de la Tienda Windows, aplicaciones de escritorio]

Servidor mínimo admitido

Windows Server 2012 [Aplicaciones de la Tienda Windows, aplicaciones de escritorio]

Espacio de nombres

Windows.Globalization.DateTimeFormatting
Windows::Globalization::DateTimeFormatting [C++]

Metadatos

Windows.winmd

Vea también

Ejemplo de formato de fecha y hora

 

 

Mostrar:
© 2017 Microsoft