Saltar al contenido

timezone_name_from_abbr()

Introducción

En este artículo, cubriremos la sintaxis, los parámetros y el valor de retorno de la función de PHP timezone_name_from_abbr(), junto con ejemplos prácticos de su uso.

Comprender la función de PHP timezone_name_from_abbr()

La función timezone_name_from_abbr() de PHP se utiliza para obtener el nombre de la zona horaria a partir de su forma abreviada. Esta función devuelve el nombre de la zona horaria en caso de éxito o false en caso de fallo.

Nota: Esta función es notoriamente poco fiable porque muchas abreviaturas de zonas horarias son ambiguas o no estándar. El manual de PHP recomienda usar DateTimeZone para aplicaciones en producción. Al usar timezone_name_from_abbr(), proporcione siempre el parámetro $gmtOffset para garantizar resultados consistentes.

Sintaxis

La sintaxis de la función timezone_name_from_abbr() es la siguiente:

La sintaxis de la función PHP timezone_name_from_abbr()

php
<?php

string|false timezone_name_from_abbr(string $abbr, int $gmtOffset = -1, int $isdst = -1)

Parámetros

La función toma tres parámetros de la siguiente manera:

  • $abbr - El nombre abreviado de la zona horaria.
  • $gmtOffset - El desplazamiento GMT de la zona horaria en segundos. Este parámetro es opcional, pero muy recomendable. Si no se proporciona, la función puede devolver false o una zona horaria incorrecta debido a abreviaturas ambiguas.
  • $isdst - Una bandera que indica si la hora de verano está en vigor. Este parámetro es opcional y, si no se proporciona, la función utilizará el valor predeterminado del sistema.

Valor de retorno

La función timezone_name_from_abbr() devuelve el nombre de la zona horaria en caso de éxito o false en caso de fallo.

Ejemplos

Veamos algunos ejemplos prácticos de cómo se puede utilizar la función timezone_name_from_abbr() en PHP.

Ejemplo de uso de la función timezone_name_from_abbr() en PHP

php
<?php

// Providing the GMT offset ensures reliable results
$tz1 = timezone_name_from_abbr('EST', -18000);
echo $tz1 !== false ? $tz1 : 'Unknown timezone'; // outputs "America/New_York"

$tz2 = timezone_name_from_abbr('PST', -28800);
echo $tz2 !== false ? $tz2 : 'Unknown timezone'; // outputs "America/Los_Angeles"

En los ejemplos anteriores, estamos pasando los nombres abreviados de las zonas horarias EST y PST junto con sus respectivos desplazamientos GMT en segundos. La función devuelve los nombres completos de las zonas horarias correspondientes, America/New_York y America/Los_Angeles respectivamente. Compruebe siempre si devuelve false para manejar los casos en los que la abreviatura no se reconoce.

Conclusión

Hemos cubierto la sintaxis y el uso de la función de PHP timezone_name_from_abbr(). Esta función puede convertir nombres de zonas horarias abreviados a sus identificadores completos, aunque generalmente se recomienda usar DateTimeZone para aplicaciones robustas. Esperamos que este artículo haya sido útil.

Práctica

¿Qué devuelve la función timezone_name_from_abbr() en PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.