本文へ移動

Wakusei Planets惑星

太陽・惑星・衛星を、線画、陰影つきの絵、表面の地図で描きます。実際の大きさ・傾き・自転つきで、任意の日時の衛星の位置も分かります。

「惑星」(わくせい) は、太陽のまわりを回る大きな星のことです。 名前について(英語)

目次

リファレンス · ある日付に、ある天体にいちばん近い天体を、空の見かけの角度か宇宙での距離でさがします。2つの天体がいちばん近づく時刻も: nearest、within、closestApproach、conjunctions

NearestOptions型

リファレンスの説明と例は英語です。見出しと目次は日本語です。

The options of nearest, within, closestApproach and conjunctions that mean the same in each.

インポート

import type { NearestOptions } from "@johnmorrisdotca/wakusei-planets/nearest";

定義

interface NearestOptions {
    count?: number;
    within?: number;
    kind?: NearestKind | readonly NearestKind[];
    bodies?: readonly BodyId[];
    by?: "sky" | "space";
    date?: When;
    observer?: Viewpoint;
}

メンバー

名前型説明
count (省略可)number | undefined

How many to return. Default 5, or all of those inside within when within is given.

within (省略可)number | undefined

Only those this close: degrees for by: "sky", kilometres for by: "space".

kind (省略可)"moon" | "star" | "planet" | "dwarf-planet" | readonly ("moon" | "star" | "planet" | "dwarf-planet")[] | undefined

Only this kind of body, or any of these kinds.

bodies (省略可)readonly BodyId[] | undefined

Search only these bodies. Default: every body.

by (省略可)"sky" | "space" | undefined

"sky" (default): the angle between the two in the sky of the observer. "space": the distance between their centres.

date (省略可)When | undefined

The moment, a Date or milliseconds since 1970 (UTC). Default: now.

observer (省略可)Viewpoint | undefined

Where the sky is seen from; ignored by by: "space". Default: the Earth's centre.

例

import { nearest, type NearestOptions } from "@johnmorrisdotca/wakusei-planets/nearest";

const options: NearestOptions = { count: 3, kind: "planet", date: Date.UTC(2026, 10, 8) };
console.log(nearest("moon", options).map((row) => row.id).join(", "));
venus, mercury, jupiter

出力(このページを作ったときに実行した結果)

ソースを見るGitHub で編集@johnmorrisdotca/wakusei-planets 0.24.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。