github.com/segmentio/encoding@v0.4.0/iso8601/parse.go

package iso8601

import (
	"encoding/binary"
	"errors"
	"time"
	"unsafe"
)

var (
	errInvalidTimestamp = errors.New("invalid ISO8601 timestamp")
	errMonthOutOfRange  = errors.New("month out of range")
	errDayOutOfRange    = errors.New("day out of range")
	errHourOutOfRange   = errors.New("hour out of range")
	errMinuteOutOfRange = errors.New("minute out of range")
	errSecondOutOfRange = errors.New("second out of range")
)

// Parse parses an ISO8601 timestamp, e.g. "2021-03-25T21:36:12Z".
func Parse(input string) (time.Time, error) {
	b := unsafeStringToBytes(input)
	if len(b) >= 20 && len(b) <= 30 && b[len(b)-1] == 'Z' {
		if len(b) == 21 || (len(b) > 21 && b[19] != '.') {
			return time.Time{}, errInvalidTimestamp
		}

		t1 := binary.LittleEndian.Uint64(b)
		t2 := binary.LittleEndian.Uint64(b[8:16])
		t3 := uint64(b[16]) | uint64(b[17])<<8 | uint64(b[18])<<16 | uint64('Z')<<24

		// Check for valid separators by masking input with "    -  -  T  :  :  Z".
		// If separators are all valid, replace them with a '0' (0x30) byte and
		// check all bytes are now numeric.
		if !match(t1, mask1) || !match(t2, mask2) || !match(t3, mask3) {
			return time.Time{}, errInvalidTimestamp
		}
		t1 ^= replace1
		t2 ^= replace2
		t3 ^= replace3
		if (nonNumeric(t1) | nonNumeric(t2) | nonNumeric(t3)) != 0 {
			return time.Time{}, errInvalidTimestamp
		}

		t1 -= zero
		t2 -= zero
		t3 -= zero
		year := (t1&0xF)*1000 + (t1>>8&0xF)*100 + (t1>>16&0xF)*10 + (t1 >> 24 & 0xF)
		month := (t1>>40&0xF)*10 + (t1 >> 48 & 0xF)
		day := (t2&0xF)*10 + (t2 >> 8 & 0xF)
		hour := (t2>>24&0xF)*10 + (t2 >> 32 & 0xF)
		minute := (t2>>48&0xF)*10 + (t2 >> 56)
		second := (t3>>8&0xF)*10 + (t3 >> 16)

		nanos := int64(0)
		if len(b) > 20 {
			for _, c := range b[20 : len(b)-1] {
				if c < '0' || c > '9' {
					return time.Time{}, errInvalidTimestamp
				}
				nanos = (nanos * 10) + int64(c-'0')
			}
			nanos *= pow10[30-len(b)]
		}

		if err := validate(year, month, day, hour, minute, second); err != nil {
			return time.Time{}, err
		}

		unixSeconds := int64(daysSinceEpoch(year, month, day))*86400 + int64(hour*3600+minute*60+second)
		return time.Unix(unixSeconds, nanos).UTC(), nil
	}

	// Fallback to using time.Parse().
	t, err := time.Parse(time.RFC3339Nano, input)
	if err != nil {
		// Override (and don't wrap) the error here. The error returned by
		// time.Parse() is dynamic, and includes a reference to the input
		// string. By overriding the error, we guarantee that the input string
		// doesn't escape.
		return time.Time{}, errInvalidTimestamp
	}
	return t, nil
}

var pow10 = []int64{1, 10, 100, 1000, 1e4, 1e5, 1e6, 1e7, 1e8}

const (
	mask1 = 0x2d00002d00000000 // YYYY-MM-
	mask2 = 0x00003a0000540000 // DDTHH:MM
	mask3 = 0x000000005a00003a // :SSZ____

	// Generate masks that replace the separators with a numeric byte.
	// The input must have valid separators. XOR with the separator bytes
	// to zero them out and then XOR with 0x30 to replace them with '0'.
	replace1 = mask1 ^ 0x3000003000000000
	replace2 = mask2 ^ 0x0000300000300000
	replace3 = mask3 ^ 0x3030303030000030

	lsb = ^uint64(0) / 255
	msb = lsb * 0x80

	zero = lsb * '0'
	nine = lsb * '9'
)

func validate(year, month, day, hour, minute, second uint64) error {
	if day == 0 || day > 31 {
		return errDayOutOfRange
	}
	if month == 0 || month > 12 {
		return errMonthOutOfRange
	}
	if hour >= 24 {
		return errHourOutOfRange
	}
	if minute >= 60 {
		return errMinuteOutOfRange
	}
	if second >= 60 {
		return errSecondOutOfRange
	}
	if month == 2 && (day > 29 || (day == 29 && !isLeapYear(year))) {
		return errDayOutOfRange
	}
	if day == 31 {
		switch month {
		case 4, 6, 9, 11:
			return errDayOutOfRange
		}
	}
	return nil
}

func match(u, mask uint64) bool {
	return (u & mask) == mask
}

func nonNumeric(u uint64) uint64 {
	// Derived from https://graphics.stanford.edu/~seander/bithacks.html#HasLessInWord.
	// Subtract '0' (0x30) from each byte so that the MSB is set in each byte
	// if there's a byte less than '0' (0x30). Add 0x46 (0x7F-'9') so that the
	// MSB is set if there's a byte greater than '9' (0x39). To handle overflow
	// when adding 0x46, include the MSB from the input bytes in the final mask.
	// Remove all but the MSBs and then you're left with a mask where each
	// non-numeric byte from the input has its MSB set in the output.
	return ((u - zero) | (u + (^msb - nine)) | u) & msb
}

func daysSinceEpoch(year, month, day uint64) uint64 {
	// Derived from https://blog.reverberate.org/2020/05/12/optimizing-date-algorithms.html.
	monthAdjusted := month - 3
	var carry uint64
	if monthAdjusted > month {
		carry = 1
	}
	var adjust uint64
	if carry == 1 {
		adjust = 12
	}
	yearAdjusted := year + 4800 - carry
	monthDays := ((monthAdjusted+adjust)*62719 + 769) / 2048
	leapDays := yearAdjusted/4 - yearAdjusted/100 + yearAdjusted/400
	return yearAdjusted*365 + leapDays + monthDays + (day - 1) - 2472632
}

func isLeapYear(y uint64) bool {
	return (y%4) == 0 && ((y%100) != 0 || (y%400) == 0)
}

func unsafeStringToBytes(s string) []byte {
	return *(*[]byte)(unsafe.Pointer(&sliceHeader{
		Data: *(*unsafe.Pointer)(unsafe.Pointer(&s)),
		Len:  len(s),
		Cap:  len(s),
	}))
}

// sliceHeader is like reflect.SliceHeader but the Data field is a
// unsafe.Pointer instead of being a uintptr to avoid invalid
// conversions from uintptr to unsafe.Pointer.
type sliceHeader struct {
	Data unsafe.Pointer
	Len  int
	Cap  int
}