Rocket - Think it. Type it. Launch it.
Mini toolsBaseMax / CalendarLibrary
The powerful library for display and convert calendar and handle the date units. (Soon)
README
CalendarLibrary
The powerful library for display and convert calendar and handle the date units.
This library will be release for C / C++.
Features
- Convert calendar units and dates.
- Display the current date.
- Convert date to string date, alphabet.
- Detecting the day of the date.
Abilities
- string display(dateDisplayType type)
- string format(string format)
- date convert(dateType target)
Example of the future:
date _date=Date(Date_Gregorian, 2019, 3, 4);
print( _date.format("Date is %y/%m/%d.\n") );Predefined constants
Date Type
| Constant | Description |
|---|---|
| DATE_GREGORIAN | Gregorian calendar |
| DATE_JALALI | Jalali calendar |
| DATE_LUNAR | Lunar calendar |
Date Display Type
| Constant | Description | Sample Output |
|---|---|---|
| DATE_ATOM | Atom | 2013-04-12T15:52:01+00:00 |
| DATE_COOKIE | HTTP Cookies | Friday, 12-Apr-13 15:52:01 UTC |
| DATE_RSS | RSS | Fri, 12 Aug 2013 15:52:01 +0000 |
| DATE_ISO8601 | ISO-8601 | 2013-04-12T15:52:01+0000 |
| DATE_W3C | World Wide Web Consortium | 2013-04-12T15:52:01+00:00 |
| DATE_RFC822 | RFC 822 | Fri, 12 Apr 13 15:52:01 +0000 |
| DATE_RFC850 | RFC 850 | Friday, 12-Apr-13 15:52:01 UTC |
| DATE_RFC1036 | RFC 1036 | Fri, 12 Apr 13 15:52:01 +0000 |
| DATE_RFC1123 | RFC 1123 | Fri, 12 Apr 2013 15:52:01 +0000 |
| DATE_RFC2822 | RFC 2822 | Fri, 12 Apr 2013 15:52:01 +0000 |
| DATE_RFC3339 | Same as DATE_ATOM | 2013-04-12T15:52:01+00:00 |
Format Specifies
| Constant | Description |
|---|---|
| %d | The day of the month (from 01 to 31) |
| %D | A textual representation of a day (three letters) |
| %j | The day of the month without leading zeros (1 to 31) |
| %l (lowercase 'L') | A full textual representation of a day |
| %N | The ISO-8601 numeric representation of a day (1 for Monday, 7 for Sunday) |
| %S | The English ordinal suffix for the day of the month (2 characters st, nd, rd or th. Works well with j) |
| %w | A numeric representation of the day (0 for Sunday, 6 for Saturday) |
| %z | The day of the year (from 0 through 365) |
| %W | The ISO-8601 week number of year (weeks starting on Monday) |
| %F | A full textual representation of a month (January through December) |
| %m | A numeric representation of a month (from 01 to 12) |
| %M | A short textual representation of a month (three letters) |
| %n | A numeric representation of a month, without leading zeros (1 to 12) |
| %t | The number of days in the given month |
| %L | Whether it's a leap year (1 if it is a leap year, 0 otherwise) |
| %o | The ISO-8601 year number |
| %Y | A four digit representation of a year |
| %y | A two digit representation of a year |
| %a | Lowercase am or pm |
| %A | Uppercase AM or PM |
| %B | Swatch Internet time (000 to 999) |
| %g | 12-hour format of an hour (1 to 12) |
| %G | 24-hour format of an hour (0 to 23) |
| %h | 12-hour format of an hour (01 to 12) |
| %H | 24-hour format of an hour (00 to 23) |
| %i | Minutes with leading zeros (00 to 59) |
| %s | Seconds, with leading zeros (00 to 59) |
| %u | Microseconds |
| %e | The timezone identifier (Examples: UTC, GMT, Atlantic/Azores) |
| %I (capital i) | Whether the date is in daylights savings time (1 if Daylight Savings Time, 0 otherwise) |
| %O | Difference to Greenwich time (GMT) in hours (Example: +0100) |
| %P | Difference to Greenwich time (GMT) in hours:minutes |
| %T | Timezone abbreviations (Examples: EST, MDT) |
| %Z | Timezone offset in seconds. The offset for timezones west of UTC is negative (-43200 to 50400) |
| %c | The ISO-8601 date (e.g. 2013-05-05T16:34:42+00:00) |
| %r | The RFC 2822 formatted date (e.g. Fri, 12 Apr 2013 12:01:05 +0200) |
| %U | The seconds since the Unix Epoch (January 1 1970 00:00:00 GMT) |
Supported Calendar Systems
| Name | Type | Group |
|---|---|---|
| Gregorian calendar | ||
| Jalali calendar | Solar | Iranian |
| Lunar calendar |
View the full list at here.
Initial Start
According to Kambiz Asadzadeh, a CPP activist, there is a shortage of library for management and control over calendar and date, and the design of such a library can help a lot of developers in the world.
Given that I recently had a project for a company close to this, it was suggested to me to write such a library.
The developers are invited to develop this libraries in other languages such as Go, Rust, ...
License
CalendarLibrary is licensed under the GNU General Public License.
