std:: formatter <std::chrono::utc_time>

std::formatter 의 특수화로, std::chrono::utc_time 에 대한 서식 규칙을 정의합니다.

• 만약 %Z 가 사용되면, 이는 "UTC" 가 CharT 로 확장된 값으로 대체됩니다.
• 만약 %z 또는 수정된 변형이 사용되면, 0min 의 오프셋이 포맷됩니다.
• 인수가 윤초 삽입 중인 시간을 나타내고 초 필드가 포맷되는 경우, 해당 필드의 정수 부분은 "60" 가 CharT 로 확장된 값입니다.

std::formatter 특수화는 일반적으로 직접 접근되지 않고, 서식 지정 함수 를 통해 사용됩니다.

형식 지정

형식 지정은 다음과 같은 형태를 가집니다

fill-and-align , width , 그리고 precision 은 표준 형식 지정 에서와 동일한 의미를 가집니다. precision 은 표현 타입 Rep 가 부동소수점 타입인 std::chrono::duration 타입에 대해서만 유효하며, 그렇지 않으면 std::format_error 가 발생합니다.

서식 지정에 사용되는 로케일은 다음과 같이 결정됩니다:

• 형식 지정자에 L 이 존재하지 않으면 기본 "C" 로케일을 사용합니다,
• 그렇지 않고 서식 지정 함수에 전달된 std::locale 이 있으면 해당 로케일을 사용합니다,
• 그 외의 경우 ( L 이 존재하지만 서식 지정 함수에 std::locale 이 전달되지 않음) 전역 로케일을 사용합니다.

만약 (일반 또는 와이드) 문자열 리터럴 인코딩 이 유니코드 인코딩 형태이고 로케일이 구현에서 정의된 로케일 집합 중 하나인 경우, 로케일에 의존하는 각 대체는 대체 문자 시퀀스가 리터럴 인코딩으로 변환된 것처럼 수행됩니다.

chrono-spec 는 하나 이상의 변환 지정자와 일반 문자( { , } , % 제외)로 구성됩니다. chrono-spec 는 반드시 변환 지정자로 시작해야 합니다. 모든 일반 문자는 수정 없이 출력에 기록됩니다. 각 수정되지 않은 변환 지정자는 % 문자로 시작하며, 그 뒤에 지정자의 동작을 결정하는 문자가 옵니다. 일부 변환 지정자는 수정된 형태를 가지며, E 또는 O 수정 문자가 % 문자 뒤에 삽입됩니다. 각 변환 지정자는 아래에 설명된 대로 출력에서 적절한 문자로 대체됩니다.

달리 명시되지 않는 한, chrono-spec 이 비어 있는 경우, chrono 객체는 다음과 같이 서식 지정 로케일( std:: locale :: classic ( ) , 전달된 std::locale 객체, 그리고 std:: locale :: global ( ) ) 중 하나)로 임뷰드 된 std:: basic_ostringstream < CharT > 타입의 객체 os 에 스트리밍 하는 것처럼 서식 지정되며, os. str ( ) 을 출력 버퍼에 복사하고 형식 지정자에 따른 추가 패딩과 조정을 수행합니다.

다음 형식 지정자를 사용할 수 있습니다:

다음 지정자들은 인식되지만, std::format_error 가 발생하게 됩니다:

예제

#include <chrono>
#include <format>
#include <iostream>
int main()
{
    std::chrono::time_point<std::chrono::utc_clock> epoch;
    std::cout << std::format("The time of the Unix epoch was {0:%F}T{0:%R%z}.", epoch)
              << '\n';
}

The time of the Unix epoch was 1970-01-01T00:00+0000.

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목