Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/chrono/c/gmtime"

From cppreference.com
< cpp‎ | chrono‎ | c
m (r2.7.3) (Robot: Adding de, es, it, pt, ru)
m (Shorten template names. Use {{lc}} where appropriate.)
Line 5: Line 5:
 
}}
 
}}
  
−
Converts given time since epoch as {{c|std::time_t}} value into calendar time, expressed in Coordinated Universal Time (UTC).  
+
Converts given time since epoch as {{lc|std::time_t}} value into calendar time, expressed in Coordinated Universal Time (UTC).  
  
 
===Parameters===
 
===Parameters===
−
{{param list begin}}
+
{{par begin}}
−
{{param list item | time | pointer to a time_t object to convert}}
+
{{par | time | pointer to a time_t object to convert}}
−
{{param list end}}
+
{{par end}}
  
 
===Return value===
 
===Return value===
−
Pointer to a static internal {{c|std::tm}} object on success, or {{c|NULL}} otherwise. The structure may shared between {{c|std::gmtime}}, {{c|std::localtime}}, and {{c|std::ctime}} and may be overwritten on each invocation.
+
Pointer to a static internal {{lc|std::tm}} object on success, or {{lc|NULL}} otherwise. The structure may shared between {{lc|std::gmtime}}, {{lc|std::localtime}}, and {{lc|std::ctime}} and may be overwritten on each invocation.
  
 
===Notes===
 
===Notes===
 
This function may not be thread-safe.
 
This function may not be thread-safe.
  
−
POSIX requires that this function sets {{c|errno}} to {{c|EOVERFLOW}} if it fails because the argument is too large.
+
POSIX requires that this function sets {{lc|errno}} to {{lc|EOVERFLOW}} if it fails because the argument is too large.
  
 
===Example===
 
===Example===
Line 40: Line 40:
  
 
===See also===
 
===See also===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list template | cpp/chrono/c/dcl list localtime}}
+
{{dsc inc | cpp/chrono/c/dcl list localtime}}
−
{{dcl list see c | c/chrono/gmtime}}
+
{{dsc see c | c/chrono/gmtime}}
−
{{dcl list end}}
+
{{dsc end}}
  
 
[[de:cpp/chrono/c/gmtime]]
 
[[de:cpp/chrono/c/gmtime]]

Revision as of 18:33, 31 May 2013

 
C++
 
Utilities library
General utilities
Relational operators (deprecated in C++20)
 
Date and time utilities
Time point
(C++11)
(C++20)
Duration
(C++11)
Clocks
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
Time of day
(C++20)(C++20)
(C++20)(C++20)
(C++20)

Calendar
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
Time zone
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)  
(C++20)
chrono I/O
(C++20)
C-style date and time
 
C-style date and time utilities
Functions
Time manipulation
(C++17)
Format conversions
gmtime
Constants
Types
(C++17)
 
Defined in header <ctime>
std::tm* gmtime( const time_t* time );

Converts given time since epoch as std::time_t value into calendar time, expressed in Coordinated Universal Time (UTC).

Contents

Parameters

time - pointer to a time_t object to convert

Return value

Pointer to a static internal std::tm object on success, or NULL otherwise. The structure may shared between std::gmtime, std::localtime, and std::ctime and may be overwritten on each invocation.

Notes

This function may not be thread-safe.

POSIX requires that this function sets errno to EOVERFLOW if it fails because the argument is too large.

Example

Run this code
#include <iostream>
#include <iomanip>
#include <ctime>
 
int main()
{
    std::time_t t = std::time(NULL);
    std::cout << "UTC:   " << std::put_time(std::gmtime(&t), "%c %Z") << '\n'
              << "local: " << std::put_time(std::localtime(&t), "%c %Z") << '\n';
}

Output: 

UTC:   Wed Dec 28 11:44:28 2011 GMT
local: Wed Dec 28 06:44:28 2011 EST

See also

Template:cpp/chrono/c/dcl list localtime
C documentation for gmtime
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/chrono/c/gmtime&oldid=49355"