carmo-evan/strtotime

A golang implementation of strtotime

strtotime

Golang implementation of strtotime, a very popular PHP function for converting English text to a timestamp. This is an exercise inspired on this Javascript implementation.

Installation

strtotime uses Go modules and is compatible with Go 1.12 upwards. Install using go get.

go get github.com/carmo-evan/strtotime

After importing it, the strtotime package will expose only one method: Parse. It takes two arguments - an English string describing some point in time; and a unix timestamp that should represent the current time, or another referencial point in time you want to use.

Try it on the playground.

package main

import (
	"fmt"
	"github.com/carmo-evan/strtotime"
	"time"
)

func main() {
    //Now is Nov 17, 2019
    u, err := strtotime.Parse("next Friday 3pm", time.Now().Unix())
    
    if err != nil {
        // crash and burn
    }

    t := time.Unix(u,0)
    
    fmt.Println(t)
    //output: 2019-11-22 15:00:00 +0000 UTC
}

Supported Formats

• yesterday
• now
• noon
• midnightOrToday
• tomorrow
• timestamp
• firstOrLastDay
• backOrFrontOf (Thank you evalevanto!)
• weekdayOf
• mssqltime
• timeLong12
• timeShort12
• timeTiny12
• soap
• wddx
• exif
• xmlRpc
• xmlRpcNoColon
• clf
• iso8601long
• dateTextual
• pointedDate4
• pointedDate2
• timeLong24
• dateNoColon
• pgydotd
• timeShort24
• iso8601noColon
• dateSlash
• american
• americanShort
• gnuDateShortOrIso8601date2
• iso8601date4
• gnuNoColon
• gnuDateShorter
• pgTextReverse
• dateFull
• dateNoDay
• dateNoDayRev
• pgTextShort
• dateNoYear
• dateNoYearRev
• isoWeekDay
• relativeText
• relative
• dayText
• relativeTextWeek
• monthFullOrMonthAbbr
• tzCorrection
• ago
• gnuNoColon2
• year4
• whitespace

Author

By Evan do Carmo

strtotime's Issues

Implement weekdayOf format

Test Cases

Input: second Friday of December 2019
Output: 1576195200, equivalent to 13/12/2019 00:00:00

format test for timestamp is failing

AIL: TestFormats/timestamp (0.00s)
        /home/zubair/projects/forked/strtotime-go/format_test.go:69: Unix stamp should've been 1569600000 but it was 1569573000

Implement backOrFrontOf Format

Test Cases

Input: November 15 2019 back of 7pm.
Output: 1573845300 equivalent to 15/11/2019 19:15:00.

Input: November 15 2019 front of 7pm.
Output: 1573843500 equivalent to 15/11/2019 18:45:00.