https://github.com/newyaroslav/time-shield-cpp
Header-only comprehensive C++ library designed for time manipulation, formatting, and conversion.
https://github.com/newyaroslav/time-shield-cpp
date-time-formatting datetime jdn time time-formatting time-utility time-utils time-zone timer timestamp ts
Last synced: 4 months ago
JSON representation
Header-only comprehensive C++ library designed for time manipulation, formatting, and conversion.
- Host: GitHub
- URL: https://github.com/newyaroslav/time-shield-cpp
- Owner: NewYaroslav
- License: mit
- Created: 2024-06-01T23:47:43.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-25T08:40:38.000Z (4 months ago)
- Last Synced: 2025-02-25T09:33:49.265Z (4 months ago)
- Topics: date-time-formatting, datetime, jdn, time, time-formatting, time-utility, time-utils, time-zone, timer, timestamp, ts
- Language: C++
- Homepage: https://newyaroslav.github.io/time-shield-cpp/
- Size: 3.04 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Time Shield
Time-Shield is ~~not only a combat tool of Homura Akemi, but also~~ a header-only C++ library designed for time manipulation. This powerful library offers a wide range of functionalities, including time conversion, string formatting, and various transformations.
## Features
- **Date Validation:** Validate dates for correctness, including leap years and day-offs.
- **Time Formatting:** Convert timestamps to formatted strings according to standard or custom patterns.
- **Time Conversions:** Convert between different time representations, including timestamps, date-time structures, and time zones.
- **Utility Functions:** Access a collection of utility functions for time-related calculations and conversions.
- Supports standards from `C++11` to `C++17`.
## Installation
To use Time Shield in your C++ projects, simply include the time_shield.hpp header file in your source code:
```cpp
#include "time_shield.hpp"
```
Then, compile your project with the Time Shield library linked.
## Usage
Here's a quick example demonstrating how to use Time Shield for time manipulation and conversion:
```cpp
#include
#include "time_shield.hpp"
int main() {
// Get the current timestamp
tsh::ts_t current_ts = tsh::timestamp(); // or ts();
// Calculate the timestamp for the end of the current year
tsh::ts_t future_ts = tsh::end_of_year(current_ts);
// Calculate the number of days between current timestamp and the future timestamp
int days = tsh::get_days_difference(current_ts, future_ts); // or days(current_ts, future_ts);
std::cout << "Days until end of year: " << days << std::endl;
// Convert the future timestamp to a formatted string in ISO8601 format
std::string formatted_time = tsh::to_iso8601_str(future_ts);
tsh::ts_ms_t ts_ms = 0;
if (!tsh::str_to_ts_ms(formatted_time, ts_ms)) {
std::cout << "Error occurred while parsing ISO8601 string" << std::endl;
return -1;
}
// Convert the milliseconds timestamp to a formatted string in ISO8601 UTC format
formatted_time = tsh::to_iso8601_utc_ms(ts_ms);
// Output the formatted time
std::cout << "Future time: " << formatted_time << std::endl;
return 0;
}
```
## Documentation
Detailed documentation for Time Shield, including API reference and usage examples, can be found [here](https://newyaroslav.github.io/time-shield-cpp/).
## License
Time Shield is licensed under the [MIT License](LICENSE).