shide
is an R package that provides date and date-time support based on Jalali calendar. jdate
and jdatetime
are two simple classes for storing Jalali dates and date-times respectively. These classes are implemented based on the infrastructure provided by the vctrs
package.
You can install shide from CRAN with:
install.packages("shide")
Or you can install the development version from GitHub:
# install.packages("devtools")
devtools::install_github("mmollayi/shide")
Features
tzdb
package.jdate
and jdatetime
are built upon numeric vectors, just like Date
and POSIXct
. So conversion between date classes (jdate
and Date
) and date-time classes (jdatetime
and POSIXct
) comes at zero cost.jdate
and jdatetime
can be used as column in a data frame.difftime
class. For example, subtraction of two jdate
s results a difftime
object.As with Date
class, a jdate
object can be generated from character and numeric vectors and also from individual components. To parse a character vector that represents Jalali dates, use jdate()
and supply a format string:
library(shide)
jdate("1402-09-13")
#> <jdate[1]>
#> [1] "1402-09-13"
jdate("1402/09/13", format = "%Y/%m/%d")
#> <jdate[1]>
#> [1] "1402-09-13"
Unlike as.Date()
, jdate()
method for numeric inputs does not expose origin
argument.
# Jalali date that corresponds to "1970-01-01"
jdate(0)
#> <jdate[1]>
#> [1] "1348-10-11"
To create a jdate
from individual components, use jdate_make()
:
jdate_make(1399, 12 ,30)
#> <jdate[1]>
#> [1] "1399-12-30"
Like jdate
a jdatetime
object can be generated from a character or numeric vector or from individual components. But a timezone should be supplied in either case:
jdatetime("1402-09-13 15:37:29", tzone = "Asia/Tehran")
#> <jdatetime<Asia/Tehran>[1]>
#> [1] "1402-09-13 15:37:29 +0330"
jdatetime("1402/09/13 15:37:29", tzone = "Asia/Tehran", format = "%Y/%m/%d %H:%M:%S")
#> <jdatetime<Asia/Tehran>[1]>
#> [1] "1402-09-13 15:37:29 +0330"
# Jalali date-time that corresponds to Unix epoch
jdatetime(0, tzone ="Asia/Tehran")
#> <jdatetime<Asia/Tehran>[1]>
#> [1] "1348-10-11 03:30:00 +0330"
jdatetime_make(1399, 12 ,30, 23, 59, 59, "Asia/Tehran")
#> <jdatetime<Asia/Tehran>[1]>
#> [1] "1399-12-30 23:59:59 +0330"
Converting other date and date-time classes to jdate
and jdatetime
is possible with as_jdate()
and as_jdatetime()
respectively:
as_jdate(as.Date("2024-07-19"))
#> <jdate[1]>
#> [1] "1403-04-29"
as_jdatetime(as.POSIXct("2024-07-19 16:25:00", tz = "Asia/Tehran"))
#> <jdatetime<Asia/Tehran>[1]>
#> [1] "1403-04-29 16:25:00 +0330"
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4