Générateur de calendrier mensuel imprimable

Année, mois et premier jour de semaine configurable

Le moteur n'appelle jamais l'objet Date de l'hôte, donc les résultats ne varient ni avec les fuseaux horaires ni avec les réglages régionaux ; le jour de semaine du premier est calculé avec l'arithmétique de Sakamoto, et la longueur de février suit la règle grégorienne des années bissextiles (divisible par quatre, sauf les années séculaires sauf si elles sont aussi divisibles par quatre cents). Envoyez deux entiers obligatoires : year dans la plage grégorienne prise en charge, et month de un pour janvier à douze pour décembre. Le paramètre optionnel first_weekday est un entier de zéro à six où zéro signifie dimanche, un lundi et six samedi ; omettez-le pour conserver la présentation classique commençant le dimanche, courante sur les calendriers muraux imprimables aux États-Unis. Les alias y et yr pour year, m et mon pour month, ainsi que week_start ou start_weekday pour l'origine de la semaine sont acceptés lorsqu'ils sont documentés. Des entrées identiques produisent toujours un JSON identique, car le chemin est une logique entière pure, sans réseau, sans graine aléatoire et sans horloge. Les champs manquants, les non-entiers, les années hors des bornes publiées, un first_weekday hors de zéro à six et tout mois inférieur à un ou supérieur à douze déclenchent invalid_input, afin que vous corrigiez la requête au lieu de recevoir un mois silencieusement reporté qui gâcherait une feuille entière.

Lecture des semaines, des en-têtes et du remplissage des jours

Le remplissage étant constitué de null explicites, les moteurs de rendu n'ont jamais à recalculer les décalages de colonnes. En cas de succès, la réponse renvoie year et month normalisés, une chaîne month_name en anglais pour les titres, et days_in_month comme longueur entière du mois. Le drapeau is_leap_year indique si l'année est bissextile selon le calendrier grégorien, même lorsque le mois n'est pas février. first_weekday et first_weekday_name décrivent l'origine de semaine demandée ; first_of_month_weekday et son nom situent le premier jour sur l'échelle absolue de dimanche à samedi, pour que les interfaces mettent en évidence le vrai début sans deviner. weekday_headers est un tableau de sept noms de jours anglais pivotés pour que la première colonne corresponde à votre first_weekday — par exemple de lundi à dimanche quand first_weekday vaut un. Le tableau weeks est le cœur du contrat : chaque entrée a un week_index et un tableau days de longueur sept où chaque case contient un numéro de jour de un à days_in_month, ou null pour le remplissage vide avant le premier et après le dernier jour. week_count est le nombre de lignes, généralement de quatre à six. calendar vaut toujours gregorian et method toujours month_calendar pour des branchements stables dans les tests. Utilisez weekday_headers pour les titres de colonnes, weeks pour les cellules d'une grille imprimable, et days_in_month quand il vous faut aussi une légende avec la longueur du mois.

Usage de l'API, tarification, flux d'impression et limites pratiques

Envoyez un corps JSON avec les champs entiers obligatoires year et month, plus first_weekday optionnel pour une semaine commençant le lundi ou un autre format régional. Recourez à l'API prépayée quand une chaîne d'impression, un générateur de fiches de classe, un produit de planification ou un agenda multi-locataire exige un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde une fois la charge rejetée. Les auteurs de SDKs peuvent projeter weeks dans des tableaux HTML ou des cellules PDF colonne par colonne, avec weekday_headers comme étiquettes de thead et les cases null comme cellules vides prêtes pour le CSS d'impression.