Grove

Light from your own sun

Abstract

How our home page knows it is dark in London at five in November, without asking anyone where they are.

Our home page changes its light through the day. Until this week it did so on a fixed timetable: dusk at a quarter past seven, night by half past eight. In a London November that is wrong by three hours. These are notes on how we fixed it.

Where is the visitor?

We did not want to ask. A permission prompt is the wrong first impression for a page whose job is to put a visitor at ease. But the browser already knows something useful: the visitor's time zone.

Intl.DateTimeFormat().resolvedOptions().timeZone   // "Europe/London"

A time zone is not a location, but it is close enough for light. We keep a short table of about seventy major zones, each placed at its main city. A zone we do not know falls back to a typical latitude for its region, and a longitude worked out from its clock.1

When does the sun rise?

With a latitude, a longitude and a date, sunrise and sunset follow from a few lines of trigonometry. We use the approximations published by NOAA, which are good to a minute or two.2 That is far more precise than we need: each change of light takes about an hour.

Hanging the day on the sun

The page has eight lights, from deep night to noon. Before, each sat at a fixed hour. Now each hangs on the visitor's own sun:

LightWhen
Before dawnup to 90 minutes before sunrise
Dawna quarter of an hour after sunrise
Noonsolar noon
Duska few minutes before sunset
Blue hourup to an hour after sunset
Nightfrom two and a half hours after sunset

In London this evening, night arrives at about five. In June it waits until after ten. In Melbourne the seasons run the other way, and the page follows without anyone telling it to.

Before the first frame

One detail mattered more than the arithmetic. The light has to be known before the browser draws anything, or the page flashes its daytime paper before turning dark. So the light is worked out by a small script that runs first, in the head of the page, before the painting or the words.

None of this is meant to look like a feature. It is meant to feel like nothing at all: the page simply looks like the sky outside your window.

Notes

  1. Travellers see the sun of whatever time zone their device is set to. That matches the clock on their screen, which is the right thing to match. Back to the text
  2. The US National Oceanic and Atmospheric Administration publishes the equations in the documentation for its solar calculator. Back to the text

La lumière de votre propre soleil

Résumé

Comment notre page d’accueil sait qu’il fait nuit à Londres à cinq heures en novembre, sans demander à personne où il se trouve.

Notre page d’accueil change de lumière au fil de la journée. Jusqu’à cette semaine, elle suivait un horaire fixe : le crépuscule à sept heures et quart, la nuit à huit heures et demie. Un mois de novembre à Londres, c’est faux de trois heures. Voici nos notes sur la façon dont nous l’avons corrigé.

Où est le visiteur ?

Nous ne voulions pas le demander. Une demande d’autorisation est une mauvaise première impression pour une page dont le rôle est de mettre le visiteur à l’aise. Mais le navigateur sait déjà une chose utile : le fuseau horaire du visiteur.

Intl.DateTimeFormat().resolvedOptions().timeZone   // "Europe/Paris"

Un fuseau horaire n’est pas un lieu, mais il en est assez proche pour la lumière. Nous tenons une courte table d’environ soixante-dix grands fuseaux, chacun placé sur sa ville principale. Un fuseau que nous ne connaissons pas se rabat sur une latitude typique de sa région, et sur une longitude déduite de son heure.1

Quand le soleil se lève-t-il ?

Avec une latitude, une longitude et une date, le lever et le coucher du soleil se déduisent en quelques lignes de trigonométrie. Nous utilisons les approximations publiées par la NOAA, précises à une ou deux minutes près.2 C’est bien plus précis qu’il ne faut : chaque changement de lumière dure environ une heure.

Accrocher la journée au soleil

La page a huit lumières, de la nuit profonde à midi. Avant, chacune avait une heure fixe. Désormais, chacune s’accroche au soleil du visiteur :

LumièreQuand
Avant l’aubejusqu’à 90 minutes avant le lever du soleil
Aubeun quart d’heure après le lever du soleil
Midimidi solaire
Crépusculequelques minutes avant le coucher du soleil
Heure bleuejusqu’à une heure après le coucher du soleil
Nuità partir de deux heures et demie après le coucher du soleil

Ce soir à Londres, la nuit tombe vers cinq heures. En juin, elle attend dix heures passées. À Melbourne, les saisons vont dans l’autre sens, et la page suit sans que personne le lui dise.

Avant la première image

Un détail comptait plus que le calcul. La lumière doit être connue avant que le navigateur ne dessine quoi que ce soit, sinon la page montre un instant son papier de jour avant de s’assombrir. La lumière est donc calculée par un petit script qui s’exécute en premier, dans l’en-tête de la page, avant le tableau et les mots.

Rien de tout cela ne doit ressembler à une fonctionnalité. Cela doit ne se remarquer en rien : la page ressemble simplement au ciel derrière votre fenêtre.

Notes

  1. Les voyageurs voient le soleil du fuseau horaire réglé sur leur appareil. Il correspond à l’horloge de leur écran, et c’est bien à elle qu’il faut correspondre. Retour au texte
  2. L’agence américaine d’observation océanique et atmosphérique (NOAA) publie les équations dans la documentation de son calculateur solaire. Retour au texte

La luce del tuo sole

Sintesi

Come la nostra pagina principale sa che a Londra, a novembre, alle cinque è già buio, senza chiedere a nessuno dove si trova.

La nostra pagina principale cambia luce nel corso della giornata. Fino a questa settimana lo faceva con un orario fisso: il crepuscolo alle sette e un quarto, la notte entro le otto e mezza. In un novembre londinese è sbagliato di tre ore. Questi sono appunti su come l'abbiamo corretto.

Dove si trova il visitatore?

Non volevamo chiederlo. Una richiesta di autorizzazione è la prima impressione sbagliata per una pagina il cui compito è mettere a proprio agio chi la visita. Ma il browser sa già qualcosa di utile: il fuso orario del visitatore.

Intl.DateTimeFormat().resolvedOptions().timeZone   // "Europe/London"

Un fuso orario non è un luogo, ma per la luce basta. Teniamo una breve tabella di circa settanta fusi principali, ciascuno collocato nella sua città più importante. Un fuso che non conosciamo ricade su una latitudine tipica della sua regione e su una longitudine ricavata dal suo orologio.1

Quando sorge il sole?

Con latitudine, longitudine e data, l'alba e il tramonto si ricavano con poche righe di trigonometria. Usiamo le approssimazioni pubblicate dalla NOAA, precise entro un paio di minuti.2 È molto più di quanto ci serva: ogni cambio di luce dura circa un'ora.

Appendere il giorno al sole

La pagina ha otto luci, dalla notte fonda al mezzogiorno. Prima ciascuna stava a un'ora fissa. Ora ciascuna è appesa al sole del visitatore:

LuceQuando
Prima dell'albafino a 90 minuti prima del sorgere del sole
Albaun quarto d'ora dopo il sorgere del sole
Mezzogiornoil mezzogiorno solare
Crepuscolopochi minuti prima del tramonto
Ora blufino a un'ora dopo il tramonto
Notteda due ore e mezza dopo il tramonto

Stasera a Londra la notte arriva verso le cinque. A giugno aspetta fin dopo le dieci. A Melbourne le stagioni vanno al contrario, e la pagina le segue senza che nessuno glielo dica.

Prima del primo fotogramma

Un dettaglio contava più dei calcoli. La luce va conosciuta prima che il browser disegni qualsiasi cosa, altrimenti la pagina mostra per un istante la carta del giorno prima di farsi scura. Per questo la luce viene calcolata da un piccolo script che parte per primo, nell'intestazione della pagina, prima del dipinto e delle parole.

Niente di tutto questo vuole sembrare una funzione. Deve sembrare niente: la pagina somiglia semplicemente al cielo fuori dalla tua finestra.

Note

  1. Chi viaggia vede il sole del fuso orario impostato sul proprio dispositivo. Coincide con l'orologio sul suo schermo, ed è giusto che sia così. Torna al testo
  2. La National Oceanic and Atmospheric Administration degli Stati Uniti pubblica le equazioni nella documentazione del suo calcolatore solare. Torna al testo

来自你自己的太阳的光

摘要

我们的首页如何在不询问任何人身在何处的情况下,知道十一月的伦敦五点就已天黑。

我们的首页会随着一天的时间变换光线。直到这周以前,它一直按固定的时刻表变化:七点一刻黄昏,八点半入夜。在伦敦的十一月,这差了三个小时。下面是我们如何修正它的笔记。

访客在哪里?

我们不想去问。对于一个要让访客感到自在的页面来说,弹出权限请求是错误的第一印象。但浏览器已经知道一件有用的事:访客的时区。

Intl.DateTimeFormat().resolvedOptions().timeZone   // "Europe/London"

时区不是位置,但对于光线来说已经足够接近。我们维护一张约七十个主要时区的简短表格,每个时区对应其主要城市。我们不认识的时区,会退回到所在地区的典型纬度,并根据其时钟推算经度。1

太阳何时升起?

有了纬度、经度和日期,几行三角函数就能算出日出和日落。我们使用 NOAA 公布的近似公式,误差在一两分钟以内。2 这远比我们需要的精确:每一次光线变化都持续大约一个小时。

把一天挂在太阳上

页面有八种光,从深夜到正午。以前,每一种都固定在某个钟点。现在,每一种都挂在访客自己的太阳上:

光何时
黎明前日出前最多 90 分钟
黎明日出后一刻钟
正午太阳正午
黄昏日落前几分钟
蓝调时刻日落后最多一小时
夜晚日落后两个半小时起

今晚的伦敦,大约五点入夜。到了六月,要等到十点以后。在墨尔本,季节正好相反,而页面会自然跟随,无需任何人告诉它。

在第一帧之前

有一个细节比计算更重要。光线必须在浏览器绘制任何内容之前就确定,否则页面会先闪现白天的纸色,再变暗。所以光线由一个最先运行的小脚本计算,它位于页面的头部,早于画作和文字。

这一切都不打算以“功能”的样子出现。它的本意是让人毫无察觉:页面看起来就像你窗外的天空。

注释

  1. 旅行者看到的是其设备所设时区的太阳。这与他们屏幕上的时钟一致,而这正是应当一致的对象。 返回正文
  2. 美国国家海洋和大气管理局在其太阳计算器的文档中公布了这些公式。 返回正文

ضوء من شمسك أنت

الملخص

كيف تعرف صفحتنا الرئيسية أن الظلام يحلّ في لندن عند الخامسة في نوفمبر، من دون أن تسأل أحدًا عن مكانه.

تغيّر صفحتنا الرئيسية ضوءها على مدار اليوم. وحتى هذا الأسبوع كانت تفعل ذلك وفق جدول ثابت: الغسق عند السابعة والربع، والليل بحلول الثامنة والنصف. وفي نوفمبر في لندن، هذا خطأ بثلاث ساعات. هذه ملاحظات عن الطريقة التي أصلحناه بها.

أين الزائر؟

لم نرد أن نسأل. فطلب الإذن انطباع أول خاطئ لصفحة مهمتها أن يشعر زائرها بالراحة. لكن المتصفح يعرف مسبقًا شيئًا مفيدًا: المنطقة الزمنية للزائر.

Intl.DateTimeFormat().resolvedOptions().timeZone   // "Europe/London"

المنطقة الزمنية ليست موقعًا، لكنها قريبة بما يكفي من أجل الضوء. نحتفظ بجدول قصير يضم نحو سبعين منطقة زمنية رئيسية، كل منها مثبتة عند مدينتها الرئيسية. أما المنطقة التي لا نعرفها، فنعود فيها إلى خط عرض نموذجي لإقليمها، وإلى خط طول نستنتجه من ساعتها.1

متى تشرق الشمس؟

بمعرفة خط العرض وخط الطول والتاريخ، يُستخرج الشروق والغروب بأسطر قليلة من حساب المثلثات. نستخدم التقريبات التي تنشرها NOAA، وهي دقيقة في حدود دقيقة أو اثنتين.2 وهذا أدق بكثير مما نحتاج: فكل تغيّر في الضوء يستغرق نحو ساعة.

تعليق اليوم على الشمس

للصفحة ثمانية أضواء، من عتمة الليل إلى الظهيرة. في السابق، كان كل منها عند ساعة ثابتة. والآن يتعلق كل منها بشمس الزائر نفسه:

الضوءمتى
قبل الفجرحتى 90 دقيقة قبل الشروق
الفجرربع ساعة بعد الشروق
الظهيرةالظهر الشمسي
الغسقدقائق قليلة قبل الغروب
الساعة الزرقاءحتى ساعة بعد الغروب
الليلابتداءً من ساعتين ونصف بعد الغروب

في لندن هذا المساء، يحلّ الليل نحو الخامسة. وفي يونيو ينتظر إلى ما بعد العاشرة. وفي ملبورن تجري الفصول على العكس، وتتبعها الصفحة من دون أن يخبرها أحد.

قبل الإطار الأول

كان هناك تفصيل أهم من الحساب. يجب أن يُعرف الضوء قبل أن يرسم المتصفح أي شيء، وإلا ومضت الصفحة بلون ورق النهار قبل أن تُعتم. لذلك يُحسب الضوء في نص برمجي صغير يعمل أولًا، في رأس الصفحة، قبل اللوحة والكلمات.

لا يُراد لشيء من هذا أن يبدو كميزة. المقصود ألا يُحَسّ به أصلًا: تبدو الصفحة ببساطة مثل السماء خارج نافذتك.

الحواشي

  1. يرى المسافر شمس المنطقة الزمنية المضبوطة على جهازه. وهي تطابق الساعة على شاشته، وهذا هو الصواب. عودة إلى النص
  2. تنشر الإدارة الوطنية للمحيطات والغلاف الجوي في الولايات المتحدة هذه المعادلات في توثيق حاسبتها الشمسية. عودة إلى النص