DEV Community

Joodi
Joodi

Posted on

3 1 1 1 1

Convert Dates to Persian Time in React

PersianTime is a simple utility to convert any date or time to Iran's local time with Persian date formatting. Whether you're building an application for Iranian users or need to handle dates in the Persian calendar, this library has got you covered!

Image description

Features

  • Convert any given date or time into Iran's local time (UTC +3:30).
  • Persian date formatting for easy reading in Iranian format.
  • Easy-to-use function for quick integration into any JavaScript/TypeScript project.

Installation

You can easily install PersianTime using npm:

npm install persiantime
Enter fullscreen mode Exit fullscreen mode

Or, if you're using Yarn:

yarn add persiantime
Enter fullscreen mode Exit fullscreen mode

Usage

Once installed, you can import and use the PersianTime function to format any date or timestamp into Persian time.

Example:

import { PersianTime } from 'persiantime';

const persianFormattedTime = PersianTime(new Date('2025-01-20T11:05:20.451Z'));

console.log(persianFormattedTime);

Enter fullscreen mode Exit fullscreen mode

In the example above, you can see that the date is converted to Persian format and Tehran local time is applied.

Handling Dates from APIs:

If you receive a date from an API in ISO format, you can use the following approach to convert it:

import { PersianTime } from 'persiantime';

const createdAt = PersianTime(new Date(document.created_at));
const updatedAt = PersianTime(new Date(document.updated_at));

console.log(createdAt);
console.log(updatedAt);

Enter fullscreen mode Exit fullscreen mode

Why PersianTime?

Accurate Time Conversion: Automatically adjusts to Iran's time zone (UTC+3:30).
Easy Integration: Works with both JavaScript and TypeScript projects.
Simple and Lightweight: Focused solely on converting date and time with minimal dependencies.
Contributing
PersianTime is an open-source project and contributions are always welcome! Feel free to fork the repo, make improvements, and create pull requests. If you encounter any issues or have suggestions for new features, please open an issue on the GitHub repository.

Support

If you find this library helpful, please consider giving it a star on GitHub and leave a review on npm. Your support will encourage me to continue improving it and adding more features.

Links

๐Ÿ”— PersianTime on npm
๐Ÿ“ฆ PersianTime GitHub Repository

Thanks for using PersianTime! ๐ŸŒŸ

Top comments (0)

Heroku

This site is powered by Heroku

Heroku was created by developers, for developers. Get started today and find out why Heroku has been the platform of choice for brands like DEV for over a decade.

Sign Up

๐Ÿ‘‹ Kindness is contagious

Immerse yourself in a wealth of knowledge with this piece, supported by the inclusive DEV Communityโ€”every developer, no matter where they are in their journey, is invited to contribute to our collective wisdom.

A simple โ€œthank youโ€ goes a long wayโ€”express your gratitude below in the comments!

Gathering insights enriches our journey on DEV and fortifies our community ties. Did you find this article valuable? Taking a moment to thank the author can have a significant impact.

Okay