Formatos de fecha y número

Los formatos de fecha/hora y número te permiten controlar la apariencia de tus datos en una hoja. Hojas de cálculo de Google ofrece una selección de formatos comunes, pero también puedes definir tus propios formatos.

En la IU de Hojas de cálculo, los formatos de número y fecha de las celdas se definen en el menú Formato > Número. En la API de Hojas de cálculo, estos formatos se definen mediante 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 para formatos de fecha y número, que puedes incluir en la solicitud de la API. En el ejemplo Establecer un formato personalizado de fecha y hora o decimal 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 aplicaciones de hojas de cálculo, considera los valores de fecha y hora como valores decimales. De esta forma, puedes realizar operaciones aritméticas con estos valores mediante fórmulas, por lo que puedes incrementar los días o las 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 hojas de cálculo. La parte de número entero 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 decimal) cuenta el tiempo como una fracción de un día. Por ejemplo, el 1 de enero de 1900 al 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 la mitad de un día. El 1 de febrero de 1900 a las 3 p.m. es 33.625.

Hojas de cálculo considera correctamente a 1900 como un año normal y no 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 con 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 token que puedes usar en un patrón de formato para fecha y hora. Un carácter + indica que el carácter anterior puede aparecer una o más veces (el patrón seguirá coincidiendo). Los caracteres que no se encuentren en la siguiente tabla se tratarán de forma literal y se mostrarán sin cambios.

Token Descripción
h Hora del día. Cambia entre el formato de 12 y 24 horas según aparezca un indicador de a.m. o p.m. en la cadena.
hh+ Igual al elemento anterior, pero con un 0 delante de 1 a 9.
m Si el token no literal anterior es de horas o el siguiente es de segundos, representa los minutos de la hora (sin 0 al principio). De lo contrario, representa el mes del año como un número (sin 0 a la izquierda).
M El mes del año sin un 0 a la izquierda. Usa este token para indicar expresamente un mes, en lugar de un minuto, en tu patrón.
mm Igual que m, pero con un 0 delante en ambos casos.
MM Es el mes del año con un 0 a la izquierda. Usa este token para indicar expresamente un mes, en lugar de un minuto, en tu patrón.
mmm Abreviatura del mes en tres letras (por ejemplo, “feb”).
mmmm Es el nombre completo del mes. mmmmmm+ también coincide con esto.
mmmmm Es la primera letra del mes (por ejemplo, "J" para junio).
s Segundos del minuto sin 0 a la izquierda.
ss Segundos del minuto con 0 a la izquierda.
[h+] Cantidad de horas transcurridas durante cierto tiempo. La cantidad de letras indica la cantidad mínima de dígitos (se agregan los 0 a la izquierda).
[m+] Cantidad de minutos transcurridos durante cierto tiempo. La cantidad de letras indica la cantidad mínima de dígitos (se agregan los 0 a la izquierda).
[s+] Cantidad de segundos transcurridos durante cierto tiempo. La cantidad de letras indica la cantidad mínima de dígitos (se agregan los 0 a la izquierda).
d Día del mes (sin 0 a la izquierda para números menores que 10).
dd Es el día del mes (con 0 a la izquierda para números menores que 10).
ddd Día de la semana, abreviatura de tres letras (por ejemplo, "lun").
dddd+ Día de la semana, nombre completo
y Año de 2 dígitos.
yy
yyy Año (4 dígitos).
yyyy+
a/p Muestra “a” para a.m. y “p” para p.m. También cambia las horas al formato de 12 horas. Si la letra del token se escribe en mayúscula, el resultado también se mostrará en mayúscula.
am/pm Igual al elemento anterior, pero se muestra “AM” o “PM” en su lugar y siempre en mayúscula.
0 Décimas de segundos. Puedes aumentar la precisión a dos dígitos con 00 o a tres dígitos (milisegundos) con 000.
\ Considera al siguiente carácter como un valor literal y no le otorga un significado especial que podría tener.
"text" Muestra el texto que se encuentre entre en las comillas como literal.

Ejemplos de formatos de fecha y hora

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

Patrones de fecha y hora Tuesday, April 5, 2016, 4:08:53.528 PM
h:mm:ss.00 a/p 4:08:53.53 p
hh:mm A/P".M." 04:08 p.m.
yyyy-mm-dd 2016-04-05
mmmm d \[dddd\] 5 de abril [martes]
h PM, ddd mmm dd 4 p.m., mar 05 de abr
dddd, m/d/yy at h:mm Martes, 5/4/16 a las 4:08 p.m.
Patrones de tiempo transcurrido 3 hours, 13 minutes, 41.255 seconds
[hh]:[mm]:[ss].000 03:13:41.255
[mmmm]:[ss].000 0193:41.255

Patrones de formato de números

Un patrón de formato de número es una cadena de subcadenas de token que, cuando se analizan, se reemplazan con las correspondientes representaciones de número. Un patrón de formato de número puede constar de hasta cuatro secciones separadas por punto y coma, que definen los formatos individuales 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, el formato se utiliza para todos los valores. Si usas dos secciones, el primer formato se aplicará a cero y a números positivos, y el segundo formato se aplicará a números negativos. Si usas tres secciones, defines formatos independientes 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 última sección es un formato de texto, esta sección se considerará formato para texto y las otras se comportarán como si hubiese una sección menos. Por lo tanto, si incluyes un formato de texto al final, es posible definir formatos como los siguientes:

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

El análisis de las secciones de un formato ocurre antes que otros análisis. En consecuencia, es posible incluir un formato de fecha o hora como una de las secciones (aunque su utilidad es limitada).

Tokens de formato de número

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

Token Descripción
0 Representa un dígito del número. Si el dígito es un 0 no significativo, se representa como 0. Por ejemplo, el formato de número 00.0 representa el número 3 como "03.0".
# Representa un dígito del número. Si el dígito es un 0 no significativo, no se representa. Por ejemplo, el formato de número ##0 representa el número 12 como "12".
? Representa un dígito del número. Si el dígito es un 0 no significativo, se representa como un espacio. Se usa generalmente para alinear el punto decimal en una columna cuando se emplean fuentes con ancho fijo. Por ejemplo, el formato de número ???.??? representa el número 12.4 como "12.4 ".
. El primer punto representa el punto decimal del número. Los puntos posteriores se representan como literales. Si incluyes un punto decimal en el formato, siempre se representará, incluso con números enteros. Por ejemplo, #0.# renderiza el número 3 como "3.".
% Aparece como un literal, pero también hace que los números existentes se multipliquen por 100 antes de la renderización para que los porcentajes sean más legibles. Por ejemplo, el formato de número #% representa el número 0.25 como “25%”.
, Si aparece entre caracteres de dos dígitos (0, # o ?), todo el número se representa con separadores de grupo (grupos de miles). Si aparece después de los caracteres de dígito, escala los dígitos a mil por coma (por ejemplo, el formato #0.0,, representa el número 12,200,000 como 12.2).
E- Representa el número en formato científico, con el formato a la izquierda de E que se usa para la parte no exponencial y el formato a la derecha de E que se usa para la parte exponencial. E+ muestra un signo + para los exponentes positivos. E- solo muestra un signo para los exponentes negativos. Si se usan letras minúsculas, el resultado e también aparece en minúsculas. Por ejemplo, el formato de número ##0.00#E+## representa el número 0.0000001 como “100.00E-9”.
E+
e-
e+
/ Si aparece entre caracteres de dos dígitos (0, # o ?), considera esos grupos de dígitos como un formato fraccional. Por ejemplo, el formato de número 0 #/# muestra el número 23.25 como 23 1/4. El denominador también puede ser un número entero literal. En ese caso, usará el entero como denominador. El formato de número 0 #/8 muestra el número 23.25 como 23 2/8. La parte fraccionaria no se representa si el numerador se convierte en 0. El número 23.1 con el formato de número 0 #/3 se muestra solo como 23 (porque el 0.1 se redondea a 0/3). / no es compatible con el formato científico ni con formatos que contengan punto decimal.
* Se incluye por cuestiones de compatibilidad con los formatos de número de Microsoft Excel. Actualmente, se ignora.
_ El token de guion bajo omite el siguiente carácter y representa un espacio. Se utiliza para alinear formatos de números cuando el valor negativo esté rodeado de paréntesis.
\ Considera al siguiente carácter como un valor literal y no le otorga un significado especial que podría tener. Por ejemplo, el formato de número \#0 representa el número 10 como "#10".
"text" Muestra el texto que se encuentre entre en las comillas como literal.
@ Si la celda tiene una entrada de texto, inserta el texto sin procesar de la celda. No es compatible con ninguno de los otros caracteres especiales y no se muestra en valores numéricos (que se muestran como formato general).
$ - + ( ) : space Hojas de cálculo trata estos caracteres como literales y los muestra sin modificaciones.

Instrucciones meta

Además, cada una de las secciones de formato puede tener metainstrucciones opcionales, que se escriben entre caracteres [], que preceden al formato y proporcionan instrucciones adicionales. Hay dos tipos de metainstrucciones, y una sección determinada puede usar ambas:

Instrucción Descripción
[condition] Reemplaza la comparación positiva, negativa o cero predeterminada de la sección con otra expresión condicional. Por ejemplo, [<100]”Low”;[>1000]”High”;000 renderiza la palabra "Low" para valores inferiores a 100, "High" para valores superiores a 1000 y un número de tres dígitos (con 0 a la izquierda) para los valores intermedios. Las condiciones solo pueden aplicarse a los primeros dos subformatos. Si un número coincide con más de uno, se usa el primero con el que coincida. Si hay un tercer formato, se usa para “todo lo demás”. De lo contrario, si un número no coincide con ningún formato, se renderiza como todos los “#” que ocupan el ancho de la celda. Si existe, el cuarto formato siempre se usa para texto.
[Color] or [Color#] Permite que los valores representados con este subformato aparezcan en el color de texto establecido. Los valores válidos para Color son Black, Blue, Cyan, Green, Magenta, Red, White o Yellow. Los valores válidos para el "#" en Color# son del 1 al 56 (esta paleta de colores muestra una lista de los colores que corresponden a cada número). Los colores de formato de número anula cualquier color que el usuario haya ingresado en la celda, pero no anula los colores establecidos por el formato condicional.

Ejemplos de formatos de número

En la siguiente tabla, se muestran patrones de ejemplo y su correspondiente representación numérica con formato:

Número Patrón Valor con formato
12345.125 ####.# 12345.1
12.34 000.0000 012.3400
12 #.0# 12.0
5.125 # ???/??? 5 1/8
12000 #,### 12,000
1230000 0.0,,"M" 1.2 M
1234500000 0.00e+00 1.23e+09
123114.15115
MiTexto		 ###0.000;"TEXT: "_(@_) 123114.151
TEXT: MyText
1234
-1234
0
MiTexto		 [Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) 1,234
1,234
0.0
MyText
1005
32
527		 [>1000]"HIGH";[Color43][<=200]"LOW";0000 ALTA
BAJA
0527