Conversor de formatos de hora de Go y strftime

Acerca de esta herramienta

Un layout es un ejemplo, no un patrón

La mayoría de los lenguajes describen un formato de fecha con marcadores como %Y-%m-%d o YYYY-MM-DD. Go lo hace de otra manera: escribes cómo debe verse un instante concreto, la hora de referencia, y time.Format imprime cualquier otra hora de la misma forma. La hora de referencia es Mon Jan 2 15:04:05 MST 2006.

Los valores se eligieron para que vayan en orden ascendente cuando se escriben en el orden estadounidense 01/02 03:04:05PM '06 -0700: mes 1, día 2, hora 3 (o 15 en formato de 24 horas), minuto 4, segundo 5, año 6 y un desfase de zona de menos 7 horas. Cada valor solo puede representar una cosa, y así es como Go sabe que 01 es un mes y 04 un minuto.

Errores frecuentes

Como 01 es el mes y 02 el día, una fecha con el día delante es 02/01/2006, algo que parece un error a cualquiera acostumbrado al orden de referencia. Un layout escrito con otros hábitos tampoco da error. Go imprime como texto literal lo que no reconoce, así que YYYY-MM-DD sale tal cual, y lee como token cada dígito que sí reconoce, así que 2021-12-25 sale como una serie de números sin relación.

No hay forma de escapar un token. El texto que por casualidad contiene uno se sustituye, así que un Jan o un Mon literal, o un dígito como 2, se convierte en un valor dentro del layout. Añade ese texto fuera del layout.

Z07:00 imprime Z para UTC y un desfase numérico en los demás casos, que es lo que espera la RFC 3339, mientras que -07:00 siempre imprime el número. En las fracciones de segundo, .000 conserva los ceros finales y .999 los elimina. Los nombres de los meses y de los días de la semana siempre están en inglés.

Cómo funcionan la vista previa y la conversión

La vista previa la genera el propio time.Format de Go, compilado a WebAssembly y ejecutado en tu navegador, así que muestra lo que imprime un programa en Go para el mismo instante y el mismo desfase. Tu navegador proporciona la hora actual, el desfase UTC de tu zona horaria y su abreviatura. Cuando el navegador no tiene abreviatura para tu zona, se usa una numérica como +03, que es también lo que imprime Go para las zonas sin letras propias. En algunas zonas, la abreviatura del navegador no coincide con la de la base de datos de zonas horarias que lee Go.

Los dos formatos no cubren lo mismo. strftime no tiene ninguna directiva que se comporte como Z07:00, y Go no tiene token para los números de semana (%U, %W, %V), para el día de la semana en número (%u, %w) ni para los segundos desde el epoch (%s). El conversor copia esas partes sin cambios y las indica debajo del campo. También indica el texto literal de un formato strftime que Go leería como token, porque un layout no puede contenerlo.

Algunas directivas de strftime son extensiones que no todas las implementaciones tienen: el modificador que quita el relleno (%-d), el desfase con dos puntos (%:z) y las directivas de fracción %L, %f y %N. Consulta la documentación del lenguaje al que conviertes.