The ethiodate package offers a fast, reliable, and user-friendly solution for converting dates between the Gregorian and Ethiopian calendar systems directly within Stata. Built in Mata for maximum computational efficiency, it provides super-fast date conversions.
# ethiodate: Ethiopian Date Conversion Utilities for Stata
The ***ethiodate*** package offers a fast, reliable, and user-friendly solution for converting dates between the Gregorian and Ethiopian calendar systems directly within Stata. Built in Mata for maximum computational efficiency, it provides super-fast date conversions.
---
## π Installation
You can install or update the latest version of **ethiodate** directly from GitHub using:
```stata
net install ethiodate, from("
raw.githubusercontent.com") replace
```
This will download and install all necessary files.
---
## π¦ Available Commands
### `to_gregorian`
Converts Ethiopian calendar date variables (year, month, day) to a single Gregorian Stata date.
```stata
to_gregorian eth_year eth_month eth_day, gre_date(newvar)
```
- `eth_year`, `eth_month`, and `eth_day`: numeric variables with Ethiopian date components.
- `gre_date()`: name of the new Gregorian Stata date variable to create.
**Example:**
```stata
to_gregorian eth_yr eth_mo eth_dy, gre_date(greg_date)
```
### `to_ethiopian`
Converts Gregorian calendar date variable to Ethiopian date components: year, month, day.
```stata
to_ethiopian gre_date, eth_year(newvar) eth_month(newvar) eth_day(newvar)
```
- `eth_year`, `eth_month`, and `eth_day`: new numeric variables name of Ethiopian date components.
- `gre_date()`: name of the Gregorian Stata date variable to convert.
**Example:**
```stata
to_gregorian eth_yr eth_mo eth_dy, gre_date(greg_date)
to_ethiopian greg_date
```
---
## π Help
To get detailed documentation in Stata, type:
```stata
help ethiodate
help to_gregorian
help to_ethiopian
```
## π Features
- Fully vectorized, efficient and precise date conversion
- Supports use within data cleaning and transformation pipelines
- Compatible with Stata 10.0 and later
- Clear help files and user instructions
---
## π¨βπ» Author
**Gutama Girja Urago**
Research Analyst at Laterite Consulting PLC
Li β¦