IntlDateFormatter::localtime

datefmt_localtime

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

IntlDateFormatter::localtime -- datefmt_localtime — Convertir una cadena en un valor de marca de tiempo basado en un campo

Descripción

Estilo orientado a objetos

public IntlDateFormatter::localtime(string $value, int &$position = ?): array

Estilo por procedimientos

datefmt_localtime(IntlDateFormatter $fmt, string $value, int &$position = ?): array

Convierte la cadena $value a un valor de instante basado en un campo (un array de varios campos),, empezando en la posición dada por $parse_pos y consumiendo tanto del valor de entrada como sea posible.

Parámetros

fmt: El recurso del formateador.
value: La cadena que convertir a un instante
position: La posición a la cual empezar la conversión de $value (basado en cero). Si no ocurre ningún error antes de que $value sea consumido, $parse_pos contendrá -1, de otro modo contendrá la posición en la que finaliza la conversión (ocurrido el error). Si $parse_pos > strlen($value), la conversión falla automáticamente.

Valores devueltos

Un array Localtime compatible array of integers : contains 24 hour clock value in tm_hour field

Ejemplos

Ejemplo #1 Ejemplo de datefmt_localtime()

<?php

$fmt = datefmt_create(
    'en_US',
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'America/Los_Angeles',
    IntlDateFormatter::GREGORIAN
);
$array = datefmt_localtime($fmt, 'Wednesday, December 31, 1969 4:00:00 PM PT', 0);
echo 'La primera salida convertida es ';
if ($array) {
    foreach ($array as $clave => $valor) {
        echo "$clave : $valor , ";
    }
}

?>

Ejemplo #2 Ejemplo orientado a objetos

<?php
$fmt = new IntlDateFormatter(
    'en_US',
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'America/Los_Angeles',
    IntlDateFormatter::GREGORIAN
);
$array = $fmt->localtime('Wednesday, December 31, 1969 4:00:00 PM PT', 0);
echo 'La primera salida convertida es ';
if ($array) {
    foreach ($array as $clave => $valor) {
        echo "$clave : $valor , ";
    }
}

?>

El resultado del ejemplo sería:

La primera salida convertida es tm_sec : 0 , tm_min : 0 , tm_hour : 16 , tm_year : 1969 , 
tm_mday : 31 , tm_wday : 4 , tm_yday : 365 , tm_mon : 11 , tm_isdst : 0 ,

Ver también

datefmt_create() - Crear un formateador de fechas
datefmt_format() - Formatear el valor fecha/hora como una cadena
datefmt_parse() - Convertir una cadena en un valor de marca de tiempo
datefmt_get_error_code() - Obtener el código del error de la última operación
datefmt_get_error_message() - Obtener el texto del error de la última operación

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

Patanjali ¶

7 years ago

Learning lesson here: Never trust the PHP documentation. Test everything!

$position does not work as described, at least in PHP 7. After parsing without errors, it does not contain -1.

You can still use it to set the parsing start character position, but not necessarily whether any errors occurred.

To test for errors, replace my $nPosition test code in the other note with:
<?php 
// Check if errors
$bError = intl_is_failure(datefmt_get_error_code(oIDF));

// If no error
if(!$bError){
 // Use 'tm_hour' and 'tm_min' from the $aTime array for checking against other time values
 ...
}else{
 // Invalid string
 ...
}
?>

down

Patanjali ¶

7 years ago

You can use datefmt_localtime to convert a user's time string, input using their locale's script, into standard numbers for checking, using a simple HTML input element.

This avoids using clunky HTML select elements formatted with hour and minute options in the locale's script to capture user input.

<?php
// Specify locale of user
$sLocale = 'en-us'; // US English user
$sLocale = 'ar-ye'; // Yemen Arab user

// Create a date formatter for the user's locale
$oIDF = datefmt_create($sLocale, IntlDateFormatter::NONE, IntlDateFormatter::SHORT);

// Simulate a user's time input string
$sTime = datefmt_format($oIDF, ['tm_hour'=>15, 'tm_min'=>25]);
// For a US English user, $sTime = '3:25 PM'
// For a Yemen Arab user, $sTime = '٣:٢٥ م'

// Specify datefmt_locale parsing start at the beginning of the user input
$nPosition = 0;

// Convert input time string to array of standard numeric values, as per localtime() output (http://php.net/manual/en/function.localtime.php)
$aTime = datefmt_localtime($oIDF, $sTime, $nPosition);
// If no errors, $nPosition set to -1 after parsing, else character position of error

// If valid string
if($nPosition = -1){
 // Use 'tm_hour' and 'tm_min' from the $aTime array for checking against other time values
 ...
}else{
 // Invalid string
 ...
}
?>

＋add a note