https://github.com/wagslane/go-tinytime

Time struct in Go that uses 4 bytes of memory vs the 24 bytes of time.Time
https://github.com/wagslane/go-tinytime

Last synced: 6 days ago
JSON representation

Time struct in Go that uses 4 bytes of memory vs the 24 bytes of time.Time

• Host: GitHub
• URL: https://github.com/wagslane/go-tinytime
• Owner: wagslane
• License: mit
• Created: 2020-04-01T14:09:58.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-12-15T17:17:31.000Z (11 months ago)
• Last Synced: 2024-08-10T10:56:10.617Z (3 months ago)
• Language: Go
• Homepage: https://blog.boot.dev/golang/announcing-go-tinytime-go-tinydates-sister-package/
• Size: 135 KB
• Stars: 78
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-tinytime

A tiny time object in Go. Tinytime uses **4 bytes** of memory vs the **24 bytes** of a standard `time.Time{}`

A tinytime only supports dates from `1970` to `2106`. It uses a unix timestamp as a `uint32`.

[![](https://godoc.org/github.com/wagslane/go-tinytime?status.svg)](https://godoc.org/github.com/wagslane/go-tinytime)

## ⚙️ Installation

```bash

go get github.com/wagslane/go-tinytime

```

## 🚀 Quick Start

```golang

package main

import (

    tinytime "github.com/wagslane/go-tinytime"

)

func main(){

    tt, err := tinytime.New(1585750374)

    if err != nil {

        fmt.Println(err.Error())

    }

    

    tt = tt.Add(time.Hour * 48)

    fmt.Println(tt)

    // prints 2020-04-03T14:12:54Z

}

```

## Need More Date Ranges? Go-TinyDate

Unix timestamps only supports dates from `1970` to `2106`.

If you need a larger date range, take a look at [go-tinydate](https://github.com/wagslane/go-tinydate) which uses `day-month-year` underneath. Keep in mind go-tinydate doesn't support more than `day` precision.

## Why?

If you don't have resource constraints, then don't use tinytime! Use the standard [time](https://golang.org/pkg/time/) pacakge.

go-tinytime works well in the following situations:

* You're okay with only to-the-second precision

* You're working in embedded systems where memory is a luxury

* You're storing many dates and smaller memory footprint is desired

* You're 101% sure you don't need a date range larger than 1970-2106

## 💬 Contact

[![Twitter Follow](https://img.shields.io/twitter/follow/wagslane.svg?label=Follow%20Wagslane&style=social)](https://twitter.com/intent/follow?screen_name=wagslane)

Submit an issue (above in the issues tab)

## API

Godoc: https://godoc.org/github.com/wagslane/go-tinytime

Tinytime mirrors the [time.Time](https://golang.org/pkg/time/) API for the most part. The only methods that are *not* included are the ones that makes no sense without timezone support.

## Formatting 

All formatting is done via the time.Time package's formatting capabilites.

## Transient Dependencies

None! And it will stay that way, except of course for the standard library.

Note: Currently the testify package is used **only** for testing, but that dependency will be removed in coming updates.

## 👏 Contributing

I love help! Contribute by forking the repo and opening pull requests. Please ensure that your code passes the existing tests and linting, and write tests to test your changes if applicable.

All pull requests should be submitted to the "master" branch.

```bash

go test

```

```bash

go fmt

```