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!

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

Or, if you're using Yarn:

yarn add persiantime

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);

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);

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! 🌟