Formatos de fecha y número

Los formatos de fecha y hora, y de número te permiten controlar cómo aparecen tus datos en una hoja. Hojas de cálculo de Google proporciona algunos formatos comunes para elegir, pero también puedes definir tus propios formatos.

En la IU de Hojas de cálculo, puedes aplicar formatos de números y fechas a las celdas con el menú Formato > Número. En la API de Hojas de cálculo, estableces estos formatos con una llamada al método spreadsheets.batchUpdate para enviar un UpdateCellsRequest o un RepeatCellRequest.

En esta página, se describe cómo definir nuevos patrones de formato de fecha y número, que puedes incluir en tu solicitud a la API. En el ejemplo Cómo configurar un formato decimal o de fecha y hora personalizado para un rango, se muestra cómo establecer un patrón de formato con la API. Ten en cuenta que la renderización real del formato depende del locale de la hoja de cálculo. En esta guía, se supone que locale es en_US. Para determinar el locale de una hoja de cálculo, lee el SpreadsheetProperties con una solicitud spreadsheets.get.

Acerca de los valores de fecha y hora

Hojas de cálculo, como la mayoría de las otras aplicaciones de hoja de cálculo, trata los valores de fecha y hora como valores decimales. Esto te permite realizar operaciones aritméticas en fórmulas, de modo que puedas incrementar días o semanas, sumar o restar dos fechas y horas, y realizar otras operaciones similares.

Hojas de cálculo usa una forma de fecha de época que se usa comúnmente en las hojas de cálculo. La parte entera del valor (a la izquierda del decimal) cuenta los días desde el 30 de diciembre de 1899. La parte fraccionaria (a la derecha del punto decimal) cuenta el tiempo como una fracción de un día. Por ejemplo, el 1 de enero de 1900 a mediodía es 2.5, 2 porque son 2 días después del 30 de diciembre de 1899 y 0.5 porque el mediodía es medio día. El 1 de febrero de 1900 a las 3 p.m. es 33.625.

Hojas de cálculo trata correctamente el año 1900 como un año común, no como un año bisiesto.

Patrones de formato de fecha y hora

Un patrón de formato de fecha y hora es una cadena de subcadenas de tokens que, cuando se analizan, se reemplazan por los elementos de fecha y hora correspondientes (como el mes o la hora).

Tokens de formato de fecha y hora

En la siguiente tabla, se definen las subcadenas de tokens que puedes usar en un patrón de formato de fecha y hora. Un carácter + indica que el carácter anterior puede aparecer una o más veces y, de todos modos, coincidir con el patrón. Los caracteres que no aparecen en la siguiente tabla se tratan como literales y se muestran sin cambios.

Ejemplos de formatos de fecha y hora

Dada la fecha y la hora Tuesday, April 5, 2016, 4:08:53.528 PM, en la siguiente tabla, se muestran algunos patrones de ejemplo y su renderización de fecha y hora correspondiente. En la segunda sección de la tabla, se muestran ejemplos de formatos de tiempo transcurrido para un tiempo transcurrido de 3 hours, 13 minutes, 41.255 seconds:

Patrones de formato de número

Un patrón de formato de número es una cadena de subcadenas de tokens que, cuando se analizan, se reemplazan por las representaciones numéricas correspondientes. Un patrón de formato de número puede constar de hasta cuatro secciones, separadas por punto y coma, que definen los formatos separados que se usan para números positivos, números negativos, cero y texto (en ese orden):

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

No es necesario que incluyas las cuatro secciones en un formato. Si solo incluyes una sección, se usará ese formato para todos los valores. El uso de dos secciones hace que el primer formato se aplique a los números cero y positivos, y el segundo formato a los números negativos. El uso de tres secciones define formatos separados para números positivos, negativos y cero. Por ejemplo:

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

Sin embargo, si hay dos o más secciones y la sección final es un formato de texto, esa sección se trata como el formato de texto y las demás se comportan como si hubiera una sección menos. Por lo tanto, si incluyes un formato de texto final, es posible definir formatos como los siguientes:

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

El análisis de un formato en secciones ocurre antes de otros análisis, por lo que es posible incluir un formato de fecha o hora como una de las secciones (aunque esto tiene una utilidad limitada).

Tokens de formato numérico

En la siguiente tabla, se definen las subcadenas de tokens que puedes usar en una sección de formato para definir cómo representar los valores de esa sección.

Instrucciones de meta

Además, cada una de las secciones de formato puede tener instrucciones meta opcionales, encerradas en caracteres [], que preceden al formato y proporcionan instrucciones adicionales. Existen dos tipos de instrucciones meta, y una sección determinada puede usar ambos:

Ejemplos de formatos de número

En la siguiente tabla, se muestran algunos ejemplos de patrones y su correspondiente renderización de números con formato: