wenyan-lang/wenyan

吾嘗觀『曆法』之書 (Date library implementation proposal)

Open

#425 opened on Dec 29, 2019

View on GitHub
 (6 comments) (4 reactions) (0 assignees)TypeScript (19,271 stars) (1,096 forks)batch import
help wantedstdlib

Description

I have an idea on the implementation of date library:

Wenyan JS equivalent
吾有一時。名之曰「今」。 var 今 = new Date();
吾有一時。曰二千八年八月八日八時八分八秒。名之曰「昔」。 var 昔 = new Date(2008, 8 - 1, 8, 8, 8, 8);
夫「今」之年。 今.getFullYear();
夫「今」之月。 今.getMonth() + 1;
夫「今」之日。 今.getDate();
夫「今」之時。 今.getHours();
夫「今」之分。 今.getMinutes();
夫「今」之秒。 今.getSeconds();
夫「今」之毫秒。 今.getMilliseconds();
夫「今」之曜。 今.getDay();
昔之「昔」之年者。今二千十八是矣。 昔.setFullYear(2018);
昔之「昔」之月者。今十二是矣。 昔.setMonth(12 - 1);

TODO add functions for date-time calculations (no JS equivalents yet)

Contributor guide

Tech stack
typescriptjavascript
Domain
api
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
basic knowledge of wenyanJavaScript Date API
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
55
Research direction
Review existing built in function implementations in the wenyan compiler (e.g., in 'src' directory). Study the JavaScript Date API to ensure accurate mapping. The issue provides a clear mapping for basic getters and setters. For the TODO date time calculations, research existing proposals or patterns in other languages, and then design the wenyan syntax accordingly. Check if there are any community discussions or linked issues for further context.