jalcal
Conversion Between Jalali (Persian or Solar Hijri) and Gregorian Calendar Dates
Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
✓DOI references
Found 3 DOI reference(s) in README -
○Academic publication links
-
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (11.5%) to scientific vocabulary
Last synced: 10 months ago
·
JSON representation
Repository
Conversion Between Jalali (Persian or Solar Hijri) and Gregorian Calendar Dates
Basic Info
- Host: GitHub
- Owner: jalilian
- Language: R
- Default Branch: main
- Size: 78.1 KB
Statistics
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
- Releases: 0
Created almost 5 years ago
· Last pushed over 1 year ago
Metadata Files
Readme
README.Rmd
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# jalcal: an R package to convert Jalaali and Gregorian calendar dates
[](https://CRAN.R-project.org/package=jalcal)
## Overview
The Persian or Jalaali calendar, also called the Solar Hijri or Hijri Shamsi
calendar, is a 12-month system.
- It begins its count from the Hijra, which is July 19, 622 AD in the standard
Gregorian calendar.
- The Persian New Year begins on Nowruz, the spring equinox. This means the start
of the year is timed with the start of spring, as determined by astronomical
observations.
- The first six months have 31 days each, the next five have 30 days, and the
last month has 29 days in common years and 30 days in leap years. Each season
consists of three consecutive months.
- The exact leap year determination also relies on the vernal equinox date and
time. The calculations and conversions in this package are based on the work by
[Kazimierz M. Borkowski](http://www.astro.uni.torun.pl/~kb/kb.htm) (1996) who
used an analytical model of Earth's motion to calculate equinoxes from AD 550
to 3800 and identify leap years based on Tehran time.
- The Persian calendar is the official calandar in Iran and Afghanistan and is
also used in parts of Tajikistan and Kurdistan, particularly among Persian- and
Kurdish-speaking communities.
Borkowski, K. M. (1996). The Persian calendar for 3000 years.
*Earth, Moon, and Planets*, 74, 223–230. [doi:10.1007/BF00055188](https://doi.org/10.1007/BF00055188)
## Installation
To install the development version of `jalcal` from [GitHub](https://github.com/jalilian/jalcal), use the [remotes](https://CRAN.R-project.org/package=remotes) package:
```r
# Install remotes if not already installed
install.packages("remotes")
# Install getsat from GitHub
remotes::install_github("jalilian/jalcal")
```
To install the package from [CRAN](https://CRAN.R-project.org/package=jalcal), use the `install.packages` command:
```r
# install.packages('jalcal')
```
## Example 1: Convert Jalaali dates to Gregorian dates
To convert **Jalaali dates** (e.g., `1403-12-30` and `1404-01-01`) to **Gregorian dates**, use:
```{r example1}
library("jalcal")
dates <- jal2greg(year=c(1403, 1404), month=c(12, 1), day=c(30, 1))
print(dates)
```
## Example 2: Convert Gregorian dates to Jalaali dates
To convert **Gregorian dates** to **Jalaali dates**, use:
```{r example2}
set.seed(14040101)
gdates <- sample(seq.Date(from = as.Date("561-01-01"),
to = as.Date("3177-12-31"), by = "day"),
size = 100)
jdates <- greg2jal(gdates)
cbind(gdates, jdates)
```
Owner
- Name: Abdollah Jalilian
- Login: jalilian
- Kind: user
- Location: Kermanshah, Iran
- Company: Razi University
- Website: https://jalilian.github.io
- Repositories: 13
- Profile: https://github.com/jalilian
GitHub Events
Total
- Push event: 11
Last Year
- Push event: 11
Committers
Last synced: over 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Abdollah Jalilian | s****j@g****m | 44 |
| Ali Etemadi | E****n@g****m | 1 |
Issues and Pull Requests
Last synced: 11 months ago
All Time
- Total issues: 0
- Total pull requests: 1
- Average time to close issues: N/A
- Average time to close pull requests: 11 days
- Total issue authors: 0
- Total pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 1.0
- Merged pull requests: 1
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
- 5etemadi (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 409 last-month
- Total docker downloads: 21,613
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 2
- Total maintainers: 1
cran.r-project.org: jalcal
Convert Between Jalaali (Persian or Solar Hijri) and Gregorian Calendar Dates
- Homepage: https://github.com/jalilian/jalcal
- Documentation: http://cran.r-project.org/web/packages/jalcal/jalcal.pdf
- License: GPL-2 | GPL-3 [expanded from: GPL (≥ 2)]
-
Latest release: 0.3.0
published over 1 year ago
Rankings
Forks count: 21.9%
Stargazers count: 24.2%
Dependent packages count: 29.8%
Average: 33.0%
Dependent repos count: 35.5%
Downloads: 53.9%
Maintainers (1)
Last synced:
11 months ago
Dependencies
.github/workflows/R-CMD-check.yml
actions
- actions/cache v2 composite
- actions/checkout v2 composite
- actions/checkout master composite
- actions/upload-artifact main composite
- r-lib/actions/setup-pandoc v1 composite
- r-lib/actions/setup-r v1 composite
- r-lib/actions/setup-tinytex v1 composite
DESCRIPTION
cran