File: format.go

package info (click to toggle)
golang-github-rickb777-date 1.20.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 460 kB
  • sloc: sh: 63; makefile: 3
file content (106 lines) | stat: -rw-r--r-- 3,223 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
// Copyright 2015 Rick Beton. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

package clock

import "fmt"

func clockHours(cm Clock) Clock {
	return (cm / Hour)
}

func clockHours12(cm Clock) (Clock, string) {
	h := clockHours(cm)
	if h < 1 {
		return 12, "am"
	} else if h > 12 {
		return h - 12, "pm"
	} else if h == 12 {
		return 12, "pm"
	}
	return h, "am"
}

func clockMinutes(cm Clock) Clock {
	return (cm % Hour) / Minute
}

func clockSeconds(cm Clock) Clock {
	return (cm % Minute) / Second
}

func clockMillisec(cm Clock) Clock {
	return cm % Second
}

// Hh gets the clock-face number of hours as a two-digit string.
// It is calculated from the modulo time; see Mod24.
// Note the special case of midnight at the end of a day is "24".
func (c Clock) Hh() string {
	if c == Day {
		return "24"
	}
	cm := c.Mod24()
	return fmt.Sprintf("%02d", clockHours(cm))
}

// HhMm gets the clock-face number of hours and minutes as a five-character ISO-8601 time string.
// It is calculated from the modulo time; see Mod24.
// Note the special case of midnight at the end of a day is "24:00".
func (c Clock) HhMm() string {
	if c == Day {
		return "24:00"
	}
	cm := c.Mod24()
	return fmt.Sprintf("%02d:%02d", clockHours(cm), clockMinutes(cm))
}

// HhMmSs gets the clock-face number of hours, minutes, seconds as an eight-character ISO-8601 time string.
// It is calculated from the modulo time; see Mod24.
// Note the special case of midnight at the end of a day is "24:00:00".
func (c Clock) HhMmSs() string {
	if c == Day {
		return "24:00:00"
	}
	cm := c.Mod24()
	return fmt.Sprintf("%02d:%02d:%02d", clockHours(cm), clockMinutes(cm), clockSeconds(cm))
}

// Hh12 gets the clock-face number of hours as a one- or two-digit string, followed by am or pm.
// Remember that midnight is 12am, noon is 12pm.
// It is calculated from the modulo time; see Mod24.
func (c Clock) Hh12() string {
	cm := c.Mod24()
	h, sfx := clockHours12(cm)
	return fmt.Sprintf("%d%s", h, sfx)
}

// HhMm12 gets the clock-face number of hours and minutes, followed by am or pm.
// Remember that midnight is 12am, noon is 12pm.
// It is calculated from the modulo time; see Mod24.
func (c Clock) HhMm12() string {
	cm := c.Mod24()
	h, sfx := clockHours12(cm)
	return fmt.Sprintf("%d:%02d%s", h, clockMinutes(cm), sfx)
}

// HhMmSs12 gets the clock-face number of hours, minutes and seconds, followed by am or pm.
// Remember that midnight is 12am, noon is 12pm.
// It is calculated from the modulo time; see Mod24.
func (c Clock) HhMmSs12() string {
	cm := c.Mod24()
	h, sfx := clockHours12(cm)
	return fmt.Sprintf("%d:%02d:%02d%s", h, clockMinutes(cm), clockSeconds(cm), sfx)
}

// String gets the clock-face number of hours, minutes, seconds and milliseconds as a 12-character ISO-8601
// time string (calculated from the modulo time, see Mod24), specified to the nearest millisecond.
// Note the special case of midnight at the end of a day is "24:00:00.000".
func (c Clock) String() string {
	if c == Day {
		return "24:00:00.000"
	}
	cm := c.Mod24()
	return fmt.Sprintf("%02d:%02d:%02d.%03d", clockHours(cm), clockMinutes(cm), clockSeconds(cm), clockMillisec(cm))
}