Date Picker Integration — Sana tanlovchi komponentlarni ulash
Date | null va string qiymatlar, useController orqali DatePicker vidjetlarini ulash, cross-field sana validatsiyasi va API formatiga o'tkazish.
68-dars
Date Picker Integration
Date Picker Integration — bu oddiy <input type="date"> o'rniga maxsus (custom) yoki tashqi kutubxonalarning DatePicker komponentlarini (kalendar popup, sana oralig'i / date range, vaqt bilan birga / datetime yoki Date / ISO string / Dayjs / Luxon qiymat qaytaruvchi vidjetlar) React Hook Form bilan bog'lash jarayonidir.
Standart HTML <input type="date"> brauzerga bog'liq ko'rinishga ega va faqat "YYYY-MM-DD" ko'rinishidagi matn qaytaradi. Zamonaviy UI kutubxonalari (shadcn/ui, MUI X Date Pickers, Mantine, Ant Design, React Datepicker) esa o'zining popover kalendariga ega bo'lib, o'zgarish hodisasida to'g'ridan-to'g'ri Date | null yoki kutubxona obyektini qaytaradi. Shuning uchun ularni <Controller> yoki useController() orqali field.value, field.onChange, field.onBlur va field.ref bilan ulash eng toza va xavfsiz usul hisoblanadi.
1. Date Picker ulashda asosiy nuqtalar
| Jihat | Nimaga e'tibor berish kerak? | Tavsiya etiladigan yondashuv |
|---|---|---|
Qiymat tipi (Date | null vs string) |
UI komponent Date obyekti qaytarishi mumkin, lekin backend API ko'pincha ISO 8601 ("2026-11-20T00:00:00.000Z") yoki "YYYY-MM-DD" kutadi. |
FormValues ichida komponentga qulay bo'lgan Date | null tipini saqlang va onSubmit ichida backend kutgan formatga o'giring. |
defaultValues boshlang'ich qiymati |
Boshlang'ich qiymat berilmasa, React Hook Form uni undefined deb oladi va controlled komponent ogohlantirish (uncontrolled to controlled) berishi mumkin. |
Bo'sh holat uchun undefined emas, aniq null (yoki bo'sh matn "") bering. |
| Sana validatsiyasi (cross-field) | Masalan, tugash sanasi (endDate) boshlanish sanasidan (startDate) oldin bo'lmasligi yoki ma'lum yosh/chegaradan kichik bo'lmasligi kerak. |
rules={{ validate: (val, formValues) => ... }} orqali sanalarning getTime() qiymatini taqqoslang va trigger() bilan o'zaro bog'lang. |
| Serverga yuborish va Timezone | new Date().toISOString() yoki JSON.stringify() chaqirilganda foydalanuvchining mahalliy vaqti UTC ga o'tishi natijasida sana 1 kunga surilib qolishi mumkin. |
Faqat sana (kun/oy/yil) kerak bo'lsa, mahalliy yildan, oydan va kundan iborat "YYYY-MM-DD" formatini hosil qiling. |
| Fokus va Accessibility (a11y) | Kalendar popup ochilganda klaviatura orqali boshqarish va xato paytida fokuslanish qiyinlashishi mumkin. | field.ref ni trigger tugmaga yoki asosiy inputga bog'lang hamda aria-invalid atributini qo'shing. |
2. Yordamchi sana funksiyalari (Timezone-safe)
Sanalarni "YYYY-MM-DD" ko'rinishida formatlash va parslashda mahalliy vaqtni (local timezone) saqlab qoluvchi yordamchi funksiyalar:
// Date obyektini mahalliy "YYYY-MM-DD" satriga o'tkazadi
export function formatInputDate(date: Date | null): string {
if (!date || Number.isNaN(date.getTime())) return "";
const year = date.getFullYear();
const month = String(date.getMonth() + 1).padStart(2, "0");
const day = String(date.getDate()).padStart(2, "0");
return `${year}-${month}-${day}`;
}
// "YYYY-MM-DD" satrini mahalliy Date obyektiga o'tkazadi
export function parseInputDate(raw: string): Date | null {
if (!raw) return null;
const parts = raw.split("-").map(Number);
if (parts.length !== 3) return null;
const [y, m, d] = parts;
if (!y || !m || !d) return null;
// Mahalliy vaqt bo'yicha 00:00:00 ga sozlaymiz
const parsed = new Date(y, m - 1, d, 0, 0, 0, 0);
return Number.isNaN(parsed.getTime()) ? null : parsed;
}
3. Reusable Custom DatePicker va useController() komponenti
Tashqi kalendar picker'lar yoki o'zingiz yasagan modal/popover vidjetlar uchun universal useController() o'rami:
import React from "react";
import {
useController,
type Control,
type FieldValues,
type Path,
type RegisterOptions,
} from "react-hook-form";
// Custom UI DatePicker komponentining prop interfeysi
type CustomDatePickerProps = {
id?: string;
value: Date | null;
onChange: (date: Date | null) => void;
onBlur?: () => void;
minDate?: Date;
invalid?: boolean;
};
// Tashqi kutubxona yoki maxsus kalendar o'rnida ishlovchi misol komponent
export function CustomDatePicker({
id,
value,
onChange,
onBlur,
minDate,
invalid,
}: CustomDatePickerProps) {
const minAttr = minDate ? formatInputDate(minDate) : undefined;
return (
<div className="date-picker-container" style={{ display: "inline-flex", gap: "8px", alignItems: "center" }}>
<input
id={id}
type="date"
min={minAttr}
value={formatInputDate(value)}
onChange={(e) => onChange(parseInputDate(e.target.value))}
onBlur={onBlur}
aria-invalid={invalid}
className={invalid ? "input-error" : ""}
/>
{value && (
<button
type="button"
onClick={() => onChange(null)}
title="Sanani tozalash"
style={{ padding: "2px 8px", cursor: "pointer" }}
>
✕
</button>
)}
</div>
);
}
// React Hook Form bilan integratsiya qiluvchi universal komponent
type FormDatePickerFieldProps<T extends FieldValues> = {
name: Path<T>;
control: Control<T>;
label: string;
minDate?: Date;
rules?: RegisterOptions<T, Path<T>>;
};
export function FormDatePickerField<T extends FieldValues>({
name,
control,
label,
minDate,
rules,
}: FormDatePickerFieldProps<T>) {
const { field, fieldState } = useController({
name,
control,
rules,
});
const dateId = `datepicker-${String(name)}`;
return (
<div className="form-field" style={{ marginBottom: "16px" }}>
<label htmlFor={dateId} style={{ display: "block", marginBottom: "4px", fontWeight: 600 }}>
{label}
</label>
<CustomDatePicker
id={dateId}
value={(field.value as Date | null) ?? null}
onChange={field.onChange}
onBlur={field.onBlur}
minDate={minDate}
invalid={fieldState.invalid}
/>
{fieldState.error && (
<p role="alert" style={{ color: "#e11d48", fontSize: "13px", marginTop: "4px" }}>
{fieldState.error.message}
</p>
)}
</div>
);
}
4. To'liq forma misoli: Cross-field sana validatsiyasi
Quyidagi misolda loyiha bosqichlari uchun boshlanish sanasi (startDate) va yakuniy muddat (deadlineDate) tanlanadi. deadlineDate hech qachon startDate sanasidan oldin bo'lishi mumkin emas:
import React from "react";
import { useForm, type SubmitHandler } from "react-hook-form";
import {
FormDatePickerField,
formatInputDate,
} from "./FormDatePicker";
type MilestoneScheduleFormValues = {
startDate: Date | null;
deadlineDate: Date | null;
};
export function MilestoneScheduleForm() {
const {
control,
trigger,
handleSubmit,
reset,
formState: { isSubmitting },
} = useForm<MilestoneScheduleFormValues>({
mode: "onChange",
defaultValues: {
startDate: new Date(2026, 10, 20), // 2026-11-20 boshlang'ich qiymat
deadlineDate: null,
},
});
const onSubmit: SubmitHandler<MilestoneScheduleFormValues> = async (data) => {
// API simulyatsiyasi
await new Promise((resolve) => setTimeout(resolve, 400));
// Backend kutgan YYYY-MM-DD formatiga aylantirib yuboramiz
const payload = {
startDate: formatInputDate(data.startDate),
deadlineDate: formatInputDate(data.deadlineDate),
};
console.log("Serverga yuborilayotgan sana ma'lumotlari:", payload);
reset({
startDate: null,
deadlineDate: null,
});
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate style={{ maxWidth: "420px" }}>
{/* 1. Boshlanish sanasi */}
<FormDatePickerField
name="startDate"
control={control}
label="Boshlanish sanasi"
rules={{
required: "Boshlanish sanasini tanlash shart",
onChange: () => {
// startDate o'zgarganda deadlineDate validatsiyasini qayta tekshiramiz
void trigger("deadlineDate");
},
}}
/>
{/* 2. Tugash sanasi (Deadline) — Cross-field tekshiruv bilan */}
<FormDatePickerField
name="deadlineDate"
control={control}
label="Tugash sanasi (Deadline)"
rules={{
required: "Tugash muddatini tanlang",
validate: (value, formValues) => {
const deadline = value as Date | null;
const start = formValues.startDate;
if (!deadline || !start) return true;
// Vaqt farqlarisiz faqat sanalarning o'zini solishtirish
const startMidnight = new Date(start.getFullYear(), start.getMonth(), start.getDate()).getTime();
const deadlineMidnight = new Date(deadline.getFullYear(), deadline.getMonth(), deadline.getDate()).getTime();
return (
deadlineMidnight >= startMidnight ||
"Tugash sanasi boshlanish sanasidan oldin bo'lishi mumkin emas"
);
},
}}
/>
<button
type="submit"
disabled={isSubmitting}
style={{
padding: "8px 18px",
background: "#2563eb",
color: "#fff",
border: "none",
borderRadius: "6px",
cursor: isSubmitting ? "not-allowed" : "pointer",
}}
>
{isSubmitting ? "Saqlanmoqda..." : "Jadvalni saqlash"}
</button>
</form>
);
}
5. Timezone muammosi va uning oldini olish
Ko'plab dasturchilar Date obyektini serverga yuborishda quyidagi xatoga yo'l qo'yadilar:
// Xato yondashuv:
const payload = {
date: data.startDate?.toISOString(), // "2026-11-19T19:00:00.000Z" (O'zbekiston UTC+5 bo'lgani uchun kechagi kunga o'tib qoladi!)
};
Agar sizga faqat sana (kun, oy, yil) kerak bo'lsa (masalan, tug'ilgan kun, pasport berilgan sana, loyiha muddati), hech qachon universal UTC toISOString() dan to'g'ridan-to'g'ri foydalanmang.
To'g'ri strategiya:
- Faqat sana kerak bo'lsa:
formatInputDate(date)orqali mahalliy yil, oy va kundan iborat"YYYY-MM-DD"satrini yuboring. - Aniq vaqt kerak bo'lsa (datetime, bron qilish vaqti): Foydalanuvchining mahalliy timezone offset'i bilan birga ISO formatida yuboring yoki
date.toISOString()yuborilayotganini backend jamoasi bilan aniqlashtirib oling.
6. Xulosa va tavsiyalar
nullboshlang'ich qiymat: Controlled DatePicker'larning bo'sh holati uchundefaultValuesdaundefinedo'rniganullbering.useControllerko'prigi: Custom kalendar, popover va tashqi UI kutubxonalar(val: Date | null) => voidinterfeysida ishlagani uchunfield.onChangevafield.valueorqali toza ulanadi.trigger()bilan sinxronlash: Boshlanish sanasi o'zgargandatrigger("deadlineDate")ni chaqirish orqali ikkinchi maydondagi xatolikni bir zumda to'g'rilash yoki ogohlantirish mumkin.- Kun boshi (
00:00:00) bo'yicha taqqoslash: SanalarnigetTime()orqali taqqoslashda soat va daqiqalar farqi sababli bir xil kundagi sanalar noto'g'ri xato bermasligi uchun ularni00:00:00ga keltiring.