Namespaces
Variants

std::chrono:: parse

From cppreference.net
Definido en el encabezado <chrono>
template < class CharT, class Parsable >
/* sin especificar */ parse ( const CharT * fmt, Parsable & tp ) ;
(1) (desde C++20)
template < class CharT, class Traits, class Alloc, class Parsable >

/* no especificado */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,

Parsable & tp ) ;
(2) (desde C++20)
template < class CharT, class Traits, class Alloc, class Parsable >

/* no especificado */ parse ( const CharT * fmt, Parsable & tp,

std:: basic_string < CharT, Traits, Alloc > & abbrev ) ;
(3) (desde C++20)
template < class CharT, class Traits, class Alloc, class Parsable >

/* no especificado */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,
Parsable & tp,

std:: basic_string < CharT, Traits, Alloc > & abbrev ) ;
(4) (desde C++20)
template < class CharT, class Parsable >

/* no especificado */ parse ( const CharT * fmt, Parsable & tp,

std:: chrono :: minutes & offset ) ;
(5) (desde C++20)
template < class CharT, class Traits, class Alloc, class Parsable >

/* sin especificar */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,

Parsable & tp, std:: chrono :: minutes & offset ) ;
(6) (desde C++20)
template < class CharT, class Traits, class Alloc, class Parsable >

/* no especificado */ parse ( const CharT * fmt, Parsable & tp,
std:: basic_string < CharT, Traits, Alloc > & abbrev,

std:: chrono :: minutes & offset ) ;
(7) (desde C++20)
template < class CharT, class Traits, class Alloc, class Parsable >

/* no especificado */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,
Parsable & tp,
std:: basic_string < CharT, Traits, Alloc > & abbrev,

std:: chrono :: minutes & offset ) ;
(8) (desde C++20)

Retorna un objeto manip de tipo no especificado tal que, dado un objeto std:: basic_istream < CharT, Traits > is , la expresión is >> manip llama a from_stream (sin calificar, para habilitar la búsqueda dependiente de argumentos ) como sigue:

1) from_stream ( is, fmt, tp )
2) from_stream ( is, fmt. c_str ( ) , tp )
3) from_stream ( is, fmt, tp, std:: addressof ( abbrev ) )
4) from_stream ( is, fmt. c_str ( ) , tp, std:: addressof ( abbrev ) )
5) from_stream ( is, fmt, tp,
static_cast < std:: basic_string < CharT, Traits, Alloc > * > ( nullptr ) , & offset )
6) from_stream ( is, fmt. c_str ( ) , tp,
static_cast < std:: basic_string < CharT, Traits, Alloc > * > ( nullptr ) , & offset )
7) from_stream ( is, fmt, tp, std:: addressof ( abbrev ) , & offset )
8) from_stream ( is, fmt. c_str ( ) , tp, std:: addressof ( abbrev ) , & offset ) .

La expresión is >> manip es un lvalue de tipo std:: basic_istream < CharT, Traits > con el valor is .

Estas sobrecargas participan en la resolución de sobrecarga solo si la expresión from_stream correspondiente está bien formada.

Se recomienda a las implementaciones que dificulten el uso de referencias potencialmente colgantes al string de formato, por ejemplo, haciendo que los tipos de retorno no sean movibles e impidiendo que operator >> acepte lvalues de tipos de retorno.

Contenidos

Parámetros

fmt - una cadena de formato (ver abajo)
tp - objeto para almacenar el resultado del análisis
abbrev - cadena para almacenar la abreviatura o nombre de la zona horaria correspondiente al %Z especificador
offset - duración para representar el desplazamiento desde UTC correspondiente al %z especificador

Cadena de formato

La cadena de formato consiste en cero o más especificadores de conversión y caracteres ordinarios. Cada carácter ordinario, excluyendo los caracteres de espacio en blanco y el carácter nulo de terminación, coincide con un carácter idéntico del flujo de entrada, o hace que la función falle si el siguiente carácter en el flujo no es igual al comparar.

Cada carácter de espacio en blanco coincide con cero o más caracteres de espacio en blanco en el flujo de entrada.

Cada especificador de conversión sin modificar comienza con un % carácter seguido de un carácter que determina el comportamiento del especificador. Algunos especificadores de conversión tienen una forma modificada en la que un E o O carácter modificador se inserta después del % carácter. Algunos especificadores de conversión tienen una forma modificada en la que un parámetro de ancho dado como un entero decimal positivo (mostrado como N abajo) se inserta después del % carácter. Cada especificador de conversión hace que los caracteres coincidentes se interpreten como partes de tipos de fecha y hora según la tabla siguiente.

Una secuencia de caracteres en la cadena de formato que comienza con un % pero no coincide con uno de los especificadores de conversión a continuación se interpreta como caracteres ordinarios.

Si from_stream no logra analizar todo lo especificado por la cadena de formato, o si se analiza información insuficiente para especificar un resultado completo, o si el análisis revela información contradictoria, is. setstate ( std:: ios_base :: failbit ) es llamado.

Los siguientes especificadores de conversión están disponibles:

Especificador
de conversión
Explicación
%% Coincide con un carácter % literal.
%n Coincide con un carácter de espacio en blanco.
%t Coincide con cero o un carácter de espacio en blanco.
Año
%C
% N C
%EC
Analiza el siglo como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %EC interpreta la representación alternativa del siglo según la configuración regional.

%y
% N y
%Ey
%Oy
Analiza los dos últimos dígitos decimales del año. Si el siglo no se especifica de otra manera (por ejemplo, con %C), se presume que los valores en el rango [69, 99] se refieren a los años 1969 a 1999, y los valores en el rango [00, 68] se refieren a los años 2000 a 2068. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

Los comandos modificados %Ey y %Oy interpretan la representación alternativa de la configuración regional.

%Y
% N Y
%EY
Analiza el año como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 4. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %EY interpreta la representación alternativa de la configuración regional.

Mes
%b
%B
%h
Analiza el nombre completo o abreviado del mes, sin distinción entre mayúsculas y minúsculas, según la configuración regional.
%m
% N m
%Om
Analiza el mes como un número decimal (enero es 1 ). El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros iniciales pero no son obligatorios.

El comando modificado %Om interpreta la representación alternativa de la configuración regional.

Día
%d
% N d
%Od
%e
% N e
%Oe
Analiza el día del mes como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

Los comandos modificados %Od y %Oe interpretan la representación alternativa de la configuración regional.

Día de la semana
%a
%A
Analiza el nombre completo o abreviado del día de la semana, sin distinción entre mayúsculas y minúsculas, según la configuración regional.
%u
% N u
Analiza el día de la semana ISO como un número decimal (1-7), donde el lunes es 1 . El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 1. Se permiten ceros a la izquierda pero no son obligatorios.
%w
% N w
%Ow
Analiza el día de la semana como un número decimal (0-6), donde el domingo es 0 . El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 1. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %Ow interpreta la representación alternativa de la configuración regional.

Año basado en semanas ISO 8601

En la norma ISO 8601 las semanas comienzan el lunes y la primera semana del año debe cumplir los siguientes requisitos:

  • Incluye el 4 de enero
  • Incluye el primer jueves del año
%g
% N g
Analiza los dos últimos dígitos decimales del año basado en semanas ISO 8601. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.
%G
% N G
Analiza el año basado en semanas ISO 8601 como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 4. Se permiten ceros a la izquierda pero no son obligatorios.
%V
% N V
Analiza la semana ISO 8601 del año como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.
Semana/día del año
%j
% N j
Analiza el día del año como un número decimal (1 de enero es 1 ). El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 3. Se permiten ceros a la izquierda pero no son obligatorios.
%U
% N U
%OU
Analiza el número de semana del año como un número decimal. El primer domingo del año es el primer día de la semana 01. Los días del mismo año anteriores a ese están en la semana 00. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %OU interpreta la representación alternativa de la configuración regional.

%W
% N W
%OW
Analiza el número de la semana del año como un número decimal. El primer lunes del año es el primer día de la semana 01. Los días del mismo año anteriores a ese están en la semana 00. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %OW interpreta la representación alternativa de la configuración regional.

Fecha
%D Equivalente a "%m/%d/%y" .
%F
% N F
Equivalente a "%Y-%m-%d" . Si se especifica el ancho, solo se aplica al %Y .
%x
%Ex
Analiza la representación de fecha de la configuración regional.

El comando modificado %Ex interpreta la representación de fecha alternativa de la configuración regional.

Hora del día
%H
% N H
%OH
Analiza la hora (reloj de 24 horas) como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %OH interpreta la representación alternativa de la configuración regional.

%I
% N I
%OI
Analiza la hora (reloj de 12 horas) como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %OI interpreta la representación alternativa de la configuración regional.

%M
% N M
%OM
Analiza el minuto como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %OM interpreta la representación alternativa de la configuración regional.

%S
% N S
%OS
Analiza el segundo como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.

El comando modificado %OS interpreta la representación alternativa de la configuración regional.

%p Analiza los equivalentes regionales de las designaciones AM/PM asociadas con un reloj de 12 horas.
%R Equivalente a "%H:%M" .
%T Equivalente a "%H:%M:%S" .
%r Analiza la hora del reloj de 12 horas de la configuración regional.
%X
%EX
Analiza la representación de hora de la configuración regional.

El comando modificado %EX interpreta la representación de hora alternativa de la configuración regional.

Miscelánea
%c
%Ec
Analiza la representación de fecha y hora de la configuración regional.

El comando modificado %Ec interpreta la representación alternativa de fecha y hora de la configuración regional.

%z
%Ez
%Oz
Analiza el desplazamiento de UTC en el formato [+|-]hh[mm] . Por ejemplo, -0430 se refiere a 4 horas 30 minutos detrás de UTC y 04 se refiere a 4 horas adelante de UTC.

Los comandos modificados %Ez y %Oz analizan el formato [+|-]h[h][:mm] (es decir, requieren un : entre las horas y minutos y hacen opcional el cero inicial para la hora).

%Z Analiza la abreviatura o nombre de la zona horaria, tomada como la secuencia más larga de caracteres que solo contiene los caracteres A a Z , a a z , 0 a 9 , - , + , _ , y / .

Ejemplo

#include <chrono>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    auto parse = [&](auto str, auto fmt, auto o)
    {
        std::istringstream is{str};
        is.imbue(std::locale("en_US.utf-8"));
        is >> std::chrono::parse(fmt, o);
        is.fail() ? std::cout << "Parse failed!\n" : std::cout << o << '\n';
    };
    parse("01:02:03", "%H:%M:%S", std::chrono::hours{});
    parse("01:02:03", "%H:%M:%S", std::chrono::minutes{});
    parse("01:02:03", "%H:%M:%S", std::chrono::seconds{});
}

Salida posible:

1h
62min
3723s

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares publicados anteriormente de C++.

DR Aplicado a Comportamiento publicado Comportamiento correcto
LWG 3554 C++20 faltaban las sobrecargas para secuencias de tipo carácter simples terminadas en nulo añadidas

Véase también

analiza un sys_time de un flujo según el formato proporcionado
(plantilla de función)
analiza un utc_time de un flujo según el formato proporcionado
(plantilla de función)
analiza un tai_time de un flujo según el formato proporcionado
(plantilla de función)
analiza un gps_time de un flujo según el formato proporcionado
(plantilla de función)
analiza un file_time de un flujo según el formato proporcionado
(plantilla de función)
analiza un local_time de un flujo según el formato proporcionado
(plantilla de función)
analiza un year de un flujo según el formato proporcionado
(plantilla de función)
analiza un month de un flujo según el formato proporcionado
(plantilla de función)
analiza un day de un flujo según el formato proporcionado
(plantilla de función)
analiza un weekday de un flujo según el formato proporcionado
(plantilla de función)
analiza un month_day de un flujo según el formato proporcionado
(plantilla de función)
analiza un year_month de un flujo según el formato proporcionado
(plantilla de función)
analiza un year_month_day de un flujo según el formato proporcionado
(plantilla de función)
(C++11)
analiza un valor de fecha/hora de formato especificado
(plantilla de función)