fasttime

package module
Version: v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 8, 2021 License: MIT Imports: 5 Imported by: 0

README

fasttime - fast time formatting for go

godoc release goreport coverage

Getting Started

try on https://play.golang.org/p/wnb6G181qu6

package main

import (
	"time"

	"github.com/phuslu/fasttime"
)

func main() {
	println(fasttime.Strftime("%a %b %d %H:%M:%S %Z %Y", time.Now()))
}

// 1608220004
// Thu Dec 17 10:49:04 +08 2020

Benchmarks

// go test -v -cpu=4 -run=none -bench=. -benchmem strftime_test.go
package strftime_test

import (
	"io/ioutil"
	"testing"
	"time"

	itchyny "github.com/itchyny/timefmt-go"
	lestrrat "github.com/lestrrat-go/strftime"
	fasttime "github.com/phuslu/fasttime"
)

const benchfmt = `%a %b %e %H:%M:%S %Z %Y`

var now = time.Now()

func BenchmarkLestrrat(b *testing.B) {
	p, _ := lestrrat.New(benchfmt)
	for i := 0; i < b.N; i++ {
		p.Format(ioutil.Discard, now)
	}
}

func BenchmarkItchyny(b *testing.B) {
	for i := 0; i < b.N; i++ {
		itchyny.Format(now, benchfmt)
	}
}

func BenchmarkFasttime(b *testing.B) {
	for i := 0; i < b.N; i++ {
		fasttime.Strftime(benchfmt, now)
	}
}
BenchmarkLestrrat 	 2092376	       583 ns/op	      64 B/op	       1 allocs/op
BenchmarkItchyny  	 2787598	       430 ns/op	       0 B/op	       0 allocs/op
BenchmarkFasttime 	 3440578	       342 ns/op	       0 B/op	       0 allocs/op

Supported formats:

code Description
%a The abbreviated name of the day of the week according to the current locale.
%A The full name of the day of the week according to the current locale.
%b The abbreviated month name according to the current locale.
%B The full month name according to the current locale.
%c The preferred date and time representation for the current locale.
%C The century number (year/100) as a 2-digit integer.
%d The day of the month as a decimal number (range 01 to 31).
%D Equivalent to %m/%d/%y. (Yecch—for Americans only.)
%e Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space.
%F Equivalent to %Y-%m-%d (the ISO 8601 date format).
%G The ISO 8601 week-based year (see NOTES) with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %Y, except that if the ISO week number belongs to the previous or next year, that year is used instead.
%g Like %G, but without century, that is, with a 2-digit year (00-99).
%h Equivalent to %b.
%H The hour as a decimal number using a 24-hour clock (range 00 to 23).
%I The hour as a decimal number using a 12-hour clock (range 01 to 12).
%j The day of the year as a decimal number (range 001 to 366).
%k The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.)
%l The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.)
%m The month as a decimal number (range 01 to 12).
%M The minute as a decimal number (range 00 to 59).
%n A newline character.
%p Either "AM" or "PM" according to the given time value, or the corresponding strings for the current locale. Noon is treated as "PM" and midnight as "AM".
%P Like %p but in lowercase: "am" or "pm" or a corresponding string for the current locale.
%r The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to %I:%M:%S %p.
%R The time in 24-hour notation (%H:%M). For a version including the seconds, see %T below.
%s The number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
%S The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.)
%t A tab character.
%T The time in 24-hour notation (%H:%M:%S).
%u The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w.
%U The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W.
%v Equivalent to %e-%b-%Y.
%V The ISO 8601 week number (see NOTES) of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the new year. See also %U and %W.
%w The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u.
%W The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01.
%x The preferred date representation for the current locale without the time.
%X The preferred time representation for the current locale without the date.
%y The year as a decimal number without a century (range 00 to 99).
%Y The year as a decimal number including the century.
%z The +hhmm or -hhmm numeric timezone (that is, the hour and minute offset from UTC).
%Z The timezone name or abbreviation.
%+ The date and time in date(1) format.
%% A literal '%' character.

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AppendStrftime added in v0.0.3

func AppendStrftime(dst []byte, format string, t time.Time) []byte

AppendStrftime appends time t using format.

func Strftime

func Strftime(format string, t time.Time) string

Strftime formats time t using format.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL