Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ghosind/go-date
The extends of the Golang built-in time package.
https://github.com/ghosind/go-date
date datetime datetime-format go-library golang golang-package time time-formatting
Last synced: 9 days ago
JSON representation
The extends of the Golang built-in time package.
- Host: GitHub
- URL: https://github.com/ghosind/go-date
- Owner: ghosind
- License: mit
- Created: 2023-06-08T15:07:27.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-12T13:25:31.000Z (7 months ago)
- Last Synced: 2024-06-21T14:25:05.499Z (5 months ago)
- Topics: date, datetime, datetime-format, go-library, golang, golang-package, time, time-formatting
- Language: Go
- Homepage: https://pkg.go.dev/github.com/ghosind/go-date
- Size: 106 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Date
[](https://goreportcard.com/report/github.com/ghosind/go-date)
[](https://codecov.io/gh/ghosind/go-date)
[](https://pkg.go.dev/github.com/ghosind/go-date)
The extends of the Golang built-in `time` package.
## Installation
Run the following command to install the library, which requires Go 1.20 and later versions.
```sh
go get -u github.com/ghosind/go-date
```
## Getting Started
This library overwrites the built-in format layouts, the following example is a simple implementation of parsing a string:
```go
str := "2024-01-10 23:59:30"
layout := "YYYY-MM-DD HH:mm:ss"
tm, err := date.Parse(layout, str)
if err != nil {
// handle error
}
fmt.Print(tm) // 2024-01-10 23:59:30 +0000 CST
```
You can also use the `Format` method to format the `Time` to a string:
```go
tm := Date(2024, time.January, 1, 23, 59, 30, 0)
fmt.Print(fm.Format("YYYY-MM-DD HH:mm:ss")) // 2024-01-10 23:59:30
```
## Available Formats
| Format | Description | Example |
| :----: | :------------------------------------------ | :------------------: |
| `YYYY` | 4-digits year | `2023` |
| `YY` | 2-digits year | `23` |
| `MM` | 2-digits month | `01`-`12` |
| `M` | Month, beginning at 1 | `1`-`12` |
| `MMMM` | The month name | `January`-`December` |
| `MMM` | The abbreviated month name | `Jan`-`Dec` |
| `DD` | The day of month, 2-digits | `01`-`31` |
| `D` | The day of month, beginning at 1 | `1`-`31` |
| `dddd` | The day of week | `Sunday`-`Friday` |
| `ddd` | The abbreviated name of weekday | `Sun`-`Fri` |
| `d` | The day of week, beginning at 0 (Sunday) | `0`-`6` |
| `HH` | The hour of 24-hour clock, 2-digits | `00`-`23` |
| `H` | The hour of 24-hour clock, beginning at 1 | `0`-`23` |
| `hh` | The hour of 12-hour clock, 2-digits | `01`-`12` |
| `h` | The hour of 12-hour clock, beginning at 1 | `1`-`12` |
| `mm` | The minutes, 2-digits | `00`-`59` |
| `m` | The minutes | `0`-`59` |
| `ss` | The seconds, 2-digits | `00`-`59` |
| `s` | The seconds | `0`-`59` |
| `SSS` | The milliseconds, 3-digits | `000`-`999` |
| `SS` | The tens of milliseconds, 2-digits | `00`-`99` |
| `S` | The hundreds of milliseconds, 1-digit | `0`-`9` |
| `A` | Post or ante meridiem, in upper case | `AM`, `PM` |
| `a` | Post or ante meridiem, in lower case | `am`, `pm` |
| `Z` | Timezone offset from UTC, separate by colon | `-08:00` |
| `ZZ` | Timezone offset from UTC | `-0800` |