Question 1

How do I convert a Gregorian date to Persian in Go using this library?

Accepted Answer

Use ptime.New() with a time.Time instance, as shown in the README example: pt := ptime.New(time.Date(2016, time.January, 1, 12, 1, 1, 0, ptime.Iran())). This creates a ptime.Time object with the corresponding Persian date.

Question 2

Does go-persian-calendar support time zones other than Iran?

Accepted Answer

Yes, it includes location support with ptime.Iran() for Iran's timezone, but it can handle other timezones via Go's standard time.Location, though specific examples for non-Iranian zones are not detailed in the README.

Question 3

What are the differences between Iranian and Dari Persian month names in the library?

Accepted Answer

The library provides both variants: Iranian names are accessed with the MMM format specifier (e.g., فروردین), and Dari names with MMI (e.g., حمل), as specified in the formatting documentation, catering to regional preferences.

Question 4

How to format Persian dates with custom patterns in Go?

Accepted Answer

Use the Format() method with specifiers like 'yyyy/MM/dd' for years, months, and days, or TimeFormat() for Go's standard patterns, as demonstrated in the README with examples like '1394/11/11 یک‌شنبه 09:54:30 ب.ظ'.

Question 5

Is go-persian-calendar better than writing my own conversion functions?

Accepted Answer

Yes, for most cases: it offers a robust, tested API with full compatibility to Go's time package, saving development time. However, if you need extreme customization or support for dates before 1097, a custom solution might be necessary.

Question 6

How to get the current Persian date in Go with this library?

Accepted Answer

Call ptime.Now() to get a ptime.Time instance representing the current time, then use methods like Date() or Format() to display it in Persian, as shown in the getting started section with output like '1394 بهمن 11'.

go-persian-calendar

What is go-persian-calendar?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions