timezone_name_get()

Introducción

Este artículo cubre la función timezone_name_get en PHP. Exploraremos su sintaxis, parámetros y valores de retorno, junto con ejemplos del mundo real. Esta función es esencial para los desarrolladores que trabajan con zonas horarias y fechas, y dominarla puede mejorar significativamente la precisión de tu código.

Nota: La función timezone_name_get forma parte de la extensión intl. Asegúrate de que esté instalada y habilitada en tu entorno PHP, de lo contrario se producirá un error fatal.

Sintaxis

La función timezone_name_get tiene una sintaxis sencilla. Recibe un objeto DateTimeZone y devuelve el nombre de la zona horaria que representa. Aquí tienes la sintaxis básica:

Sintaxis de la función PHP timezone_name_get()

<‌?php

string timezone_name_get ( DateTimeZone $object )

Analicemos los parámetros:

• $object: Este es un objeto DateTimeZone que representa una zona horaria.

Parámetros

Como se mencionó anteriormente, la función timezone_name_get solo toma un parámetro: un objeto DateTimeZone. Este objeto representa una zona horaria específica y se crea utilizando la clase DateTimeZone. Aquí tienes un ejemplo de cómo crear un objeto DateTimeZone:

Ejemplo de creación de objeto DateTimeZone en PHP

<‌?php

$timezone = new DateTimeZone('America/New_York');

En este ejemplo, creamos un objeto DateTimeZone que representa la Zona Horaria del Este en Estados Unidos.

Nota: En PHP 8+, se aplica la verificación estricta de tipos. Pasar un argumento que no sea un objeto DateTimeZone generará un TypeError.

Valores de retorno

La función timezone_name_get devuelve una cadena que representa el nombre de la zona horaria representada por el objeto DateTimeZone pasado como parámetro. Aquí tienes un ejemplo de cómo se puede usar:

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

<‌?php

$timezone = new DateTimeZone('America/New_York');
echo timezone_name_get($timezone); // Output: America/New_York

Try it Yourself »

En este ejemplo, creamos un objeto DateTimeZone que representa la Zona Horaria del Este y luego lo pasamos a la función timezone_name_get. La función devuelve la cadena "America/New_York", la cual mostramos utilizando la sentencia echo.

Ejemplos del mundo real

Ahora que hemos cubierto los fundamentos de la función timezone_name_get, exploremos algunos ejemplos del mundo real sobre cómo se puede utilizar.

Ejemplo 1: Mostrar zonas horarias en un menú desplegable

Supongamos que queremos crear un formulario que permita a los usuarios seleccionar su zona horaria. Podemos usar la clase DateTimeZone junto con la función timezone_name_get para llenar un menú desplegable con todas las zonas horarias disponibles. Aquí tienes un ejemplo:

Mostrar zonas horarias en un menú desplegable en PHP

<select name="timezone">
  <‌?php foreach(DateTimeZone::listIdentifiers() as $timezone): ?>
    <option value="<‌?php echo $timezone; ?>">
      <‌?php echo $timezone; ?>
    </option>
  <‌?php endforeach; ?>
</select>

En este ejemplo, usamos el método listIdentifiers de la clase DateTimeZone para obtener una lista de todas las zonas horarias disponibles. Dado que listIdentifiers ya devuelve los nombres canónicos de las zonas horarias, podemos usar $timezone directamente tanto para el valor como para la etiqueta, lo que hace que el código sea más eficiente.

Ejemplo 2: Convertir una fecha a otra zona horaria

Supongamos que tenemos una fecha en la Zona Horaria del Pacífico y queremos convertirla a la Zona Horaria del Este. Podemos usar la clase DateTime junto con las funciones DateTimeZone y timezone_name_get para lograrlo. Aquí tienes un ejemplo:

Convertir una fecha a otra zona horaria en PHP

<‌?php

$pacificTime = new DateTime('2022-03-01 09:00:00', new DateTimeZone('America/Los_Angeles'));
$easternTime = clone $pacificTime;
$easternTime->setTimezone(new DateTimeZone('America/New_York'));

echo 'Pacific Time: ' . $pacificTime->format('Y-m-d H:i:s') . ' (' . timezone_name_get($pacificTime->getTimezone()) . ')' . PHP_EOL;
echo 'Eastern Time: ' . $easternTime->format('Y-m-d H:i:s') . ' (' . timezone_name_get($easternTime->getTimezone()) . ')';

Try it Yourself »

En este ejemplo, creamos un objeto DateTime que representa una fecha y hora en la Zona Horaria del Pacífico, utilizando el identificador de zona horaria America/Los_Angeles. Luego, creamos una copia de este objeto y usamos el método setTimezone para convertirlo a la Zona Horaria del Este, utilizando el identificador America/New_York. Finalmente, mostramos las fechas en ambas zonas horarias usando el método format y verificamos los nombres de las zonas horarias activas mediante timezone_name_get.

Conclusión

Este artículo ha cubierto la función timezone_name_get en PHP, incluyendo su sintaxis, parámetros, valores de retorno y casos de uso prácticos. Esperamos que esta información te ayude a manejar las conversiones de zonas horarias de manera más confiable en tus proyectos.

Práctica

¿Cuál es la función del método `timezone_name_get` en PHP?

Devuelve el nombre de la zona horaria relativa al objeto DateTimeZone proporcionado.Cambia la zona horaria predeterminada de la configuración de PHP.Crea una instancia de DateTime.Devuelve el desplazamiento de la zona horaria en segundos desde UTC en caso de éxito o false en caso de error.