Session 11 examples

11-Modules/01-Module/go.mod

@@ -0,0 +1,6 @@
+module github.com/naeemaei/test
+
+go 1.18
+
+require github.com/jalaali/go-jalaali v0.0.0-20210801064154-80525e88d958 // indirect
+replace github.com/jalaali/go-jalaali => ./local/go-jalaali

11-Modules/01-Module/go.sum

@@ -0,0 +1,2 @@
+github.com/jalaali/go-jalaali v0.0.0-20210801064154-80525e88d958 h1:qxLoi6CAcXVzjfvu+KXIXJOAsQB62LXjsfbOaErsVzE=
+github.com/jalaali/go-jalaali v0.0.0-20210801064154-80525e88d958/go.mod h1:Wqfu7mjUHj9WDzSSPI5KfBclTTEnLveRUFr/ujWnTgE=

11-Modules/01-Module/local/go-jalaali/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Amir Khazaie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

11-Modules/01-Module/local/go-jalaali/README.md

@@ -0,0 +1,23 @@
+# Jalaali
+
+Golang implementation of [Jalaali JS](https://github.com/jalaali/jalaali-js) and [Jalaali Python](https://github.com/jalaali/jalaali-python) implementations of Jalaali (Jalali, Persian, Khayyami, Khorshidi, Shamsi) convertion to Gregorian calendar system and vice-versa.
+
+This implementation is based on an [algorithm by Kazimierz M. Borkowski](http://www.astro.uni.torun.pl/~kb/Papers/EMP/PersianC-EMP.htm). Borkowski claims that this algorithm works correctly for 3000 years!
+
+Documentation on API is available [here](https://pkg.go.dev/github.com/jalaali/go-jalaali) at Go official documentation site.
+
+## Installation
+
+Use `go get` on this repository:
+
+```sh
+$ go get -u github.com/jalaali/go-jalaali
+```
+
+## Usage
+
+* Wrapper around Golang [time package](https://golang.org/pkg/time):
+  * Call `Jalaali.Now()` to get instance of current time. You can use all function from `time` package with this wrapper.
+  * Call `Jalaali.From(t)` and pass a `time` instance to it. The you can work with it the same way you work with `time` package.
+* Jalaali Formatting:
+  * Call `JFormat` method of a Jalaali instance and pass it the same formatting options that is used for Golang `time` package. The output will be in Jalaali date and use persian digits and words.

11-Modules/01-Module/local/go-jalaali/convertion.go

@@ -0,0 +1,140 @@
+package jalaali
+
+import "time"
+
+var (
+	breaks = [...]int{-61, 9, 38, 199, 426, 686, 756, 818, 1111, 1181, 1210,
+		1635, 2060, 2097, 2192, 2262, 2324, 2394, 2456, 3178}
+)
+
+// ToJalaali converts Gregorian to Jalaali date. Error is not nil if Jalaali
+// year passed to function is not valid.
+func ToJalaali(gregorianYear int, gregorianMonth time.Month, gregorianDay int) (int, Month, int, error) {
+	jy, jm, jd, err := d2j(g2d(gregorianYear, int(gregorianMonth), gregorianDay))
+	return jy, Month(jm), jd, err
+}
+
+// ToGregorian converts Jalaali to Gregorian date. Error is not nil if Jalaali
+// year passed to function is not valid.
+func ToGregorian(jalaaliYear int, jalaaliMonth Month, jalaaliDay int) (int, time.Month, int, error) {
+	jdn, err := j2d(jalaaliYear, int(jalaaliMonth), jalaaliDay)
+	if err != nil {
+		return 0, 0, 0, err
+	}
+
+	gy, gm, gd := d2g(jdn)
+	return gy + 1400, time.Month(gm), gd, nil
+}
+
+func j2d(jy, jm, jd int) (jdn int, err error) {
+	_, gy, march, err := jalCal(jy)
+	if err != nil {
+		return 0, err
+	}
+	return g2d(gy, 3, march) + (jm-1)*31 - div(jm, 7)*(jm-7) + jd - 1, nil
+}
+
+func d2j(jdn int) (int, int, int, error) {
+	gy, _, _ := d2g(jdn) // Calculate Gregorian year (gy).
+	jy := gy - 621
+	leap, _, march, err := jalCal(jy)
+	jdn1f := g2d(gy, 3, march)
+
+	if err != nil {
+		return 0, 0, 0, err
+	}
+
+	// Find number of days that passed since 1 Farvardin.
+	k := jdn - jdn1f
+	if k >= 0 {
+		if k <= 185 {
+			// The first 6 months.
+			jm := 1 + div(k, 31)
+			jd := mod(k, 31) + 1
+			return jy, jm, jd, nil
+		}
+		// The remaining months.
+		k -= 186
+	} else {
+		// Previous Jalaali year.
+		jy--
+		k += 179
+		if leap == 1 {
+			k++
+		}
+	}
+	jm := 7 + div(k, 30)
+	jd := mod(k, 30) + 1
+	return jy, jm, jd, nil
+}
+
+func jalCal(jy int) (int, int, int, error) {
+	bl, gy, leapJ, jp := len(breaks), jy+621, -14, breaks[0]
+	jump := 0
+
+	if jy < jp || jy >= breaks[bl-1] {
+		return 0, 0, 0, &ErrorInvalidYear{jy}
+	}
+
+	// Find the limiting years for the Jalaali year jy.
+	for i := 1; i < bl; i++ {
+		jm := breaks[i]
+		jump = jm - jp
+		if jy < jm {
+			break
+		}
+		leapJ += div(jump, 33)*8 + div(mod(jump, 33), 4)
+		jp = jm
+	}
+	n := jy - jp
+
+	// Find the number of leap years from AD 621 to the beginning
+	// of the current Jalaali year in the Persian calendar.
+	leapJ += div(n, 33)*8 + div(mod(n, 33)+3, 4)
+	if mod(jump, 33) == 4 && jump-n == 4 {
+		leapJ++
+	}
+
+	// And the same in the Gregorian calendar (until the year gy).
+	leapG := div(gy, 4) - div((div(gy, 100)+1)*3, 4) - 150
+
+	// Determine the Gregorian date of Farvardin the 1st.
+	march := 20 + leapJ - leapG
+
+	// Find how many years have passed since the last leap year.
+	if jump-n < 6 {
+		n -= jump + div(jump+4, 33)*33
+	}
+	leap := mod(mod(n+1, 33)-1, 4)
+	if leap == -1 {
+		leap = 4
+	}
+
+	return leap, gy, march, nil
+}
+
+func g2d(gy, gm, gd int) int {
+	d := div((gy+div(gm-8, 6)+100100)*1461, 4) +
+		div(153*mod(gm+9, 12)+2, 5) +
+		gd - 34840408
+	d = d - div(div(gy+100100+div(gm-8, 6), 100)*3, 4) + 752
+	return d
+}
+
+func d2g(jdn int) (int, int, int) {
+	j := 4*jdn + 139361631
+	j = j + div(div(4*jdn+183187720, 146097)*3, 4)*4 - 3908
+	i := div(mod(j, 1461), 4)*5 + 308
+	gd := div(mod(i, 153), 5) + 1
+	gm := mod(div(i, 153), 12) + 1
+	gy := div(j, 1461) - 100100 + div(8-gm, 6)
+	return gy, gm, gd
+}
+
+func div(a, b int) int {
+	return a / b
+}
+
+func mod(a, b int) int {
+	return a % b
+}

11-Modules/01-Module/local/go-jalaali/errors.go

@@ -0,0 +1,19 @@
+package jalaali
+
+import "fmt"
+
+// ErrorNilReference is happening when a pointer is nil.
+type ErrorNilReference struct{}
+
+// ErrorInvalidYear is happening when year passed is is in proper range.
+type ErrorInvalidYear struct {
+	year int
+}
+
+func (e *ErrorNilReference) Error() string {
+	return "jalaali: reference is nil"
+}
+
+func (e *ErrorInvalidYear) Error() string {
+	return fmt.Sprintf("jalaali: %v is invalid year", e.year)
+}