시간과 언어

이 페이지는 영어에서 번역되었습니다. 영어 페이지 읽기

날짜와 시간은 업무 앱에서 흔한 버그의 원인입니다. 사용자가 여행하면 하루가 바뀌는 생일, 시계가 바뀐 후 한 시간 늦게 시작하는 근무가 그 예입니다. Zeyn은 각 종류의 값에 고유한 타입을 부여하므로 컴파일러가 이를 구분해 줍니다.

네 가지 타입

달력상의 하루를 순간으로 저장하지 마십시오. Date는 모든 시간대에서 같은 날이고, DateTime은 어디서나 같은 순간이며 시간대마다 다른 벽시계 시각으로 표시됩니다.

let day = Date::new(2026, 3, 29).unwrap_or_default();
let at = Time::new(9, 30, 0).unwrap_or_default();
let slot = LocalDateTime::new(day, at);
let zone = TimeZone::named("Europe/Istanbul").unwrap_or(TimeZone::UTC);
let moment = DateTime::from_local(slot, zone)?;
let back = moment.local(zone);

DateTime::from_local은 봄철 시계 변경 중처럼 그 시간대에 존재하지 않는 벽시계 시각에 대해 추측하지 않고 실패합니다.

시계

시스템 시계가 아니라 ctx.now()와 ctx.today()를 사용하십시오. ctx.today()는 사용자의 시간대 기준 오늘입니다. 테스트는 App::fixed_now(moment)로 모든 요청의 시계를 고정합니다.

시간대

App::new(t!("app.name"))
    .time_policy(TimePolicy::User { default: TimeZone::named("Europe/Istanbul").unwrap_or(TimeZone::UTC) })
    .time_zone_picker()

.time_zone_picker()는 메뉴에 선택기를 추가하여 사용자가 직접 시간대를 고를 수 있게 합니다. 싱글 사인온 프록시가 헤더로 시간대를 보낼 수도 있습니다(ForwardAuth::time_zone). DateTime 열의 그리드 필터는 사용자의 시간대로 읽힙니다.

피커

날짜, 시간, 날짜 시간 필드에는 키보드 친화적인 피커가 제공됩니다. DateOptions는 선택할 수 있는 범위를 제한합니다.

Form::of(visit)
    .row(|r| r.field(Visit::day).field(Visit::arrives))
    .range(Visit::stay_from, Visit::stay_to)
    .date_options(Visit::day, DateOptions::new().no_weekends().week_numbers())
    .date_options(Visit::arrives, DateOptions::new().step_minutes(15))

언어 선택

서버는 zeyn_locale 쿠키에서, 그다음 브라우저의 Accept-Language에서, 마지막으로 앱 기본값에서 언어를 고릅니다. <html lang>은 항상 이와 일치합니다. 메뉴의 언어 선택기는 쿠키를 설정하고 새로 고침 없이 페이지를 그 자리에서 교체합니다.

App::locale_paths()를 쓰면 언어가 URL의 일부가 됩니다. 기본 언어는 /orders에 그대로 있고, 다른 언어는 /tr/orders나 /ar/orders를 씁니다. 경로만으로 언어가 정해지므로 공유한 링크는 같은 언어로 열리고, 각 Screen은 여전히 라우트가 하나이며 ctx.locale()로 언어를 읽습니다. 메뉴 링크는 언어를 유지하고, 선택기는 새로 고침 없이 같은 페이지를 다른 언어로 엽니다. 아랍어처럼 오른쪽에서 왼쪽으로 쓰는 언어에는 <html dir="rtl">가 붙습니다. 공개 페이지의 언어 목록은 Screen::alternate("tr", "/tr/orders")로 검색 엔진에 알립니다.

숫자, 금액, 날짜

값은 서버에서 사용자의 언어에 맞게 서식화됩니다. 터키어는 1.234,56, 영어는 1,234.56이고, 날짜는 29.03.2026 또는 3/29/2026이며, 금액은 통화 기호와 함께 표시됩니다. 입력은 같은 형식을 다시 읽어 들입니다.

Money는 정수 최소 단위와 통화를 유지하므로 합계에서 1센트도 잃지 않습니다.

let price = Money::tl(2_500_000);
let text = price.format("tr");