Se usó la API de Cloud Translation para traducir esta página.

Formatos de fecha y número

Los formatos de fecha, hora y número te permiten controlar cómo aparecen tus datos en una hoja. Hojas de cálculo de Google ofrece 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úmero y fecha a las celdas con el Formato > Menú Número En la API de Hojas de cálculo, estableces estos formatos con un spreadsheets.batchUpdate llamada de método para enviar un UpdateCellsRequest o RepeatCellRequest

En esta página, se describe cómo definir nuevos patrones de formato de fecha y número, que puedes que puedes incluir en tu solicitud a la API. La muestra Cómo configurar un formato personalizado de fecha y hora o decimal para un rango se muestra cómo configurar 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 lo siguiente: el SpreadsheetProperties con un spreadsheets.get para cada solicitud.

Acerca de las fechas y valores de tiempo

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

Hojas de cálculo usa un formulario fecha de época que se usa comúnmente en las hojas de cálculo. La parte del número entero del valor (a la izquierda del decimal) cuenta los días desde el 30 de diciembre de 1899. La fracción (a la derecha del decimal) cuenta el tiempo como una fracción de un día. Para ejemplo, el 1 de enero de 1900 al mediodía es 2.5, 2 porque es 2 días después 30 de diciembre de 1899 y 0.5 porque el mediodía es medio día. 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.

Fecha y patrones de formato de hora

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

Fecha y tokens de formato de hora

La siguiente tabla define las substrings de token que puedes usar en un formato de fecha y hora formato. Un carácter + indica que puede aparecer el anterior. una o más veces y aun así coincidir con el patrón. Caracteres que no aparecen en el de la tabla de abajo se tratan como literales y se muestran sin cambios.

Token	Descripción
`h`	Hora del día. Cambia entre el formato de 12 y 24 horas según el si un indicador de a.m. o p.m. está presente en la cadena.
`hh+`	Igual al anterior, pero con un 0 adelante de 1 a 9.
`m`	Si el token no literal anterior era de horas o el siguiente es de segundos, representa los minutos en la hora (sin un 0 a la izquierda). De lo contrario, representa el mes del año en formato de número (sin 0 adelante).
`M`	El mes del año sin 0 adelante. 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 adelante en ambos casos.
`MM`	El mes del año con un 0 adelante. Usa este token para indicar expresamente un mes, en lugar de un minuto, en tu patrón.
`mmm`	Abreviatura del mes de tres letras (por ejemplo, “feb”).
`mmmm`	Nombre completo del mes `mmmmmm+` también coincide con esto.
`mmmmm`	Primera letra del mes (por ejemplo, “J” para junio).
`s`	Segundos del minuto sin 0 adelante.
`ss`	Segundos del minuto con un 0 adelante.
`[h+]`	Cantidad de horas transcurridas durante cierto tiempo. Cantidad de letras indica la cantidad mínima de dígitos (se agregan los 0 iniciales).
`[m+]`	Cantidad de minutos transcurridos durante cierto tiempo. Cantidad de letras indica la cantidad mínima de dígitos (se agregan los 0 iniciales).
`[s+]`	Cantidad de segundos transcurridos durante cierto tiempo. Cantidad de letras indica la cantidad mínima de dígitos (se agregan los 0 iniciales).
`d`	Día del mes, sin 0 adelante para números menores que 10.
`dd`	Día del mes, con un 0 adelante para los 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`	Año de 2 dígitos
`yyy`	Año (4 dígitos).
`yyyy+`	Año (4 dígitos).
`a/p`	Muestra "a" para AM y "p" para PM. También cambia el horario a Formato de 12 horas. Si la letra del token se escribe en mayúscula, el resultado es también.
`am/pm`	Como en el ejemplo anterior, pero muestra "a.m." o “PM” en su lugar y siempre es mayúsculas.
`0`	Décimas de segundos. Puedes aumentar la precisión a dos dígitos con `00` o tres dígitos (milisegundos) con `000`.
`\`	Trata al siguiente carácter como un valor literal y no a un valor especial. lo que podría tener.
`"text"`	Muestra el texto que esté dentro de las comillas como literal.

Fecha y ejemplos de formatos de hora

Según la fecha y hora Tuesday, April 5, 2016, 4:08:53.528 PM, el valor siguiente tabla muestra algunos patrones de ejemplo y su correspondiente fecha-hora y procesamiento. La segunda sección de la tabla muestra ejemplos de tiempo transcurrido formatos para un tiempo transcurrido 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.m.
`hh:mm A/P".M."`	04:08 P.M.
`yyyy-mm-dd`	2016-04-05
`mmmm d \[dddd\]`	Martes 5 de abril
`h PM, ddd mmm dd`	4 p. m., mar. 5 abr.
`dddd, m/d/yy at h:mm`	Martes, 5/4/16, 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, reemplazarse 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 la formatos independientes que se utilizan para números positivos, números negativos, cero y texto (en ese pedido):

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

No es necesario que incluyas las cuatro secciones en un formato. Si solo incluyes uno , ese formato se usa para todos los valores. Usar dos secciones provoca que la primera para aplicar a cero y números positivos, y el segundo formato para números negativos. Usar tres secciones define formatos separados negativo y cero números. 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 texto de lectura, esa sección se trata como el formato de texto y las demás se comportan como si hay una sección menos. Por lo tanto, si incluyes un formato de texto final, es posible para definir formatos como:

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

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

Tokens de formato de número

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

Token	Descripción
`0`	Representa un dígito del número. Si el dígito es un 0 no significativo, se renderiza como 0. Por ejemplo, el formato de número `00.0` renderiza 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 renderiza. Por ejemplo, el formato de número `##0` renderiza el número 12 como "`12`".
`?`	Representa un dígito del número. Si el dígito es un 0 no significativo, se renderiza como un espacio. Se suele usar para alinear el punto decimal en una columna cuando se usan fuentes de ancho fijo. Por ejemplo, el formato de número `???.???` renderiza el número 12.4 de la siguiente manera: ”. `12.4`".
`.`	El primer punto representa el punto decimal del número. Posterior los puntos se procesan como literales. Si incluyes un punto decimal en la siempre se renderiza, incluso con números enteros. Por ejemplo: `#0.#` renderiza el número 3 como “`3.`”.
`%`	Aparece como un literal, pero también hace que se multipliquen los números existentes. en 100 antes de renderizarse para aumentar los porcentajes sean legibles. Por ejemplo, el formato de número `#%` renderiza el número 0.25 como "`25%`".
`,`	Si aparece entre caracteres de dos dígitos (`0`, `#` o `?`), renderiza el número completo con separadores de agrupación (agrupación por miles). Si concuerda con los dígitos, los escala en mil por cada coma (por ejemplo, el formato `#0.0,,` renderiza el número 12,200,000 como `12.2`).
`E-`	Renderiza el número en formato científico, con el a la izquierda de `E` que se usa para el argumento no exponencial y el formato a la derecha de la E que se usa para el exponente porción. `E+` muestra un signo `+` para que el resultado sea positivo exponentes. `E-` solo muestra un signo para los exponentes negativos. Si se usa minúsculas, el resultado `e` también está en minúsculas. Por ejemplo, el formato de número `##0.00#E+##` renderiza el número 0.0000001 como “`100.00E-9`”.
`E+`
`e-`
`e+`
`/`	Si aparece entre caracteres de dos dígitos (`0`, `#` o `?`), trata esos grupos de dígitos como un formato fraccionario. Por ejemplo, el formato de número `0 #/#` renderiza el número 23.25 como `23 1/4`. El denominador también puede ser un número entero literal, en cuyo caso, aplica ese número entero como el denominador. El formato de número `0 #/8` muestra el número 23.25 como `23 2/8`. La parte fraccionaria no es se renderiza si el numerador pasa a ser 0. El número 23.1 con el formato de número `0 #/3` se renderiza como solo `23` (porque 0.1 se redondea a 0/3) `/` es no es compatible con el formato científico ni con un formato con punto decimal que haya en él.
`*`	Esto 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 renderiza un espacio. Se usa para alinear formatos de números en los que el valor negativo está entre paréntesis.
`\`	Trata al siguiente carácter como un valor literal y no a un valor especial. lo que podría tener. Por ejemplo, el formato de número `\#0` renderiza el número 10 como "`#10`".
`"text"`	Muestra el texto que esté dentro de las comillas como literal.
`@`	Si la celda tiene entrada de texto, se inserta el texto sin formato de la celda. No es compatible con cualquiera 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 cambios.

Meta instrucciones

Además, cada sección de formato puede tener metainstrucciones opcionales, encerrado en caracteres [], que anteceden al formato y proporcionan instrucciones adicionales. Existen dos tipos de metainstrucción y una metadada puede usar ambas:

Instrucción Descripción

[condition] Reemplaza la comparación positiva, negativa o cero predeterminada de los por otra expresión condicional. Por ejemplo: [<100]”Low”;[>1000]”High”;000 renderiza la palabra. “Bajo” para los valores inferiores a 100, “Alto” para los valores superiores a 1, 000 y un valor de tres dígitos (con 0 iniciales) para cualquier dato intermedio. Las condiciones solo pueden se aplica a los dos primeros subformatos y, si un número coincide con más de uno, utiliza el primero con el que coincida. Si hay un tercer formato, es se usa para "todo lo demás", de lo contrario, si un número no coincide se renderiza como "#" que llena el ancho de la celda. Si existe, el siempre se usa el cuarto formato para el texto.

[Color] or [Color#] Hace que cualquier valor que renderice este subformato aparezca con el color del texto determinado. Los valores válidos para Color son negro, Azul, cian, verde, magenta, rojo, blanco o amarillo. Valores válidos para "#" en Color# son 0&ndash1;56 (esta paleta de colores muestra una lista de los colores que corresponden a cada número). Formato de número los colores anulan los colores ingresados por el usuario en la celda, pero no anular colores establecidos por formato condicional

Instrucción	Descripción
`[condition]`	Reemplaza la comparación positiva, negativa o cero predeterminada de los por otra expresión condicional. Por ejemplo: `[<100]”Low”;[>1000]”High”;000` renderiza la palabra. “Bajo” para los valores inferiores a 100, “Alto” para los valores superiores a 1, 000 y un valor de tres dígitos (con 0 iniciales) para cualquier dato intermedio. Las condiciones solo pueden se aplica a los dos primeros subformatos y, si un número coincide con más de uno, utiliza el primero con el que coincida. Si hay un tercer formato, es se usa para "todo lo demás", de lo contrario, si un número no coincide se renderiza como "#" que llena el ancho de la celda. Si existe, el siempre se usa el cuarto formato para el texto.
`[Color] or [Color#]`	Hace que cualquier valor que renderice este subformato aparezca con el color del texto determinado. Los valores válidos para `Color` son negro, Azul, cian, verde, magenta, rojo, blanco o amarillo. Valores válidos para "#" en `Color#` son 0&ndash1;56 (esta paleta de colores muestra una lista de los colores que corresponden a cada número). Formato de número los colores anulan los colores ingresados por el usuario en la celda, pero no anular colores establecidos por formato condicional

Ejemplos de formatos de número

La siguiente tabla muestra algunos 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	`# ???/???`	8/15
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 TEXTO: MiTexto
1234 -1234 0 MiTexto	`[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_)`	1,234 1,234 0.0 MyText
1,005 32 527	`[>1000]"HIGH";[Color43][<=200]"LOW";0000`	ALTO BAJO 0527