date-light — 3.11KB TypeScript tarih yardımcı kütüphanesi

Bir tarih kütüphanesi eklemek isteyip de locale/timezone/duration/plugin gibi her şeye ihtiyaç duymadığınız durumlar olur.

date-light, bu sorunu çözmek için hazırlanmış küçük bir tarih yardımcı kütüphanesidir. Web/uygulamalarda sık kullanılan tarih işlemlerini seçip 39 fonksiyon halinde sunar. Çalışma zamanı bağımlılığı yoktur; TypeScript tipleri ve ESM/CJS entry point'leri içerir.

import { addDays, differenceInDays, format, startOfWeek } from "date-light";  
  
const launch = new Date(2026, 5, 30, 14, 30);  
const reminder = addDays(launch, -7);  
  
format(launch, "yyyy-MM-dd HH:mm"); // "2026-06-30 14:30"  
format(startOfWeek(launch), "yyyy-MM-dd"); // "2026-06-29"  
differenceInDays(launch, reminder); // 7  

Neler sunuyor

format, parseISO, parse

addDays, addMonths, addYears, addHours, subDays, subMonths...

differenceInDays, differenceInMonths, differenceInYears

isBefore, isAfter, isEqual, isSameDay, isSameMonth

isWeekend, isLeapYear, isValid, getDaysInMonth

startOfDay, endOfWeek, startOfMonth, endOfYear gibi

Girdi olarak verilen Date nesnesi değiştirilmez. Tüm fonksiyonlar yeni bir Date döndürür veya bir değer hesaplar.

Neden yapıldı

Çoğu uygulama, tarih kütüphanelerinin yalnızca çok küçük bir bölümünü kullanır.

Tarihi formatlamak, ISO dizelerini parse etmek, birkaç gün eklemek, iki tarih arasındaki farkı bulmak ve haftanın/ayın/yılın başlangıç ve bitişine hizalamak gibi temel işlemler yeterlidir.

date-light, kapsamı bilinçli olarak burada tutmayı tercih ediyor. Kullanım hissi date-fns'e benzer kalırken, yalnızca sık kullanılan yardımcılar bir araya getirilmiş.

Bilinçli olarak olmayanlar

locale, timezone DB, duration nesnesi, plugin ve zincirleme API yok.

Bu özelliklere ihtiyaç varsa Intl, Temporal, Luxon veya date-fns daha uygun olur. date-light, genel uygulama tarih işlemlerini küçük bir kapsamda tutmak istediğinizde kullanabileceğiniz bir araçtır.

Boyut

39 fonksiyon için yaklaşık 3.11KB minzipped.

Dokümandaki bundle boyutu karşılaştırmasına göre, date-fns'ten benzer 20 fonksiyon alındığı duruma kıyasla yaklaşık 5.9 kat daha küçüktür.

GitHub: https://github.com/flyingsquirrel0419/date-light
npm: npm install date-light
docs/playground: https://date-light.flyingsquirrel.me/