The planetary calendar room is a spacious, circular room within Wan Shi Tong's Library, capped by a large dome. The entire room is essentially one gigantic machine: By manipulating various dials on a central control panel, one is able to determine the position of the sun, moon, and stars on any given date. The results are displayed on the interior surface of the dome above.
Inside Wan Shi Tong's Library, Sokka discovered a small, burned piece of parchment, upon which was written a date and the phrase, "The Darkest Day in Fire Nation History". However, he subsequently discovered that the whole wing dedicated to the Fire Nation had been burned down, thus preventing him from finding out what happened on that day. One of the Knowledge Seekers arrived and led Sokka and the others to the calendar room. The fox creature entered through a small opening to the right of the large golden room, and opened it from the inside. When the foursome entered, the fox showed them how the planetary room worked by pushing a lever. Zei exclaimed that the room was a "true marvel; a mechanical wonder". Katara suggested that Sokka enter the date he found on the parchment onto the dials in the middle of the room. When he did so, the heavens moved and showed that the darkest day in Fire Nation history was actually a solar eclipse, thus leading Sokka to discover that firebenders lose their firebending during a solar eclipse.
After Sokka voiced aloud the first conceptions of his plan to invade the Fire Nation, Wan Shi Tong appeared, claiming that the visitors of his library had betrayed his trust by using the knowledge of the library to hurt other people. As a result of this, the Knowledge Spirit started to sink his library in order to trap everyone inside. While Katara and the professor headed for the exit, Sokka and Aang returned to the planetarium in order to find the date of the next solar eclipse. After finding out that it was only a few months away, they too left the room and the library.
This machine was built by Wan Shi Tong and his seekers using phosphorescent crystals, jade, brass, and other fine materials. Though it may seem like advanced technology, the planetary calendar works on gears and cogs like a watch and the ceiling is domed with "stars" projected from a crystal. The room uses its crystal-made stars and rotating planets to act as a kind of almanac showing both recorded history and projected future planetary alignments.
- The machine partly resembles the real-world Antikythera Mechanism, an ancient Greek clockwork device used for calculating the positions of celestial bodies. Though significantly smaller in size, the core mechanisms involved are similar: after the desired date is input by adjusting ring-shaped dials of varying sizes, a series of intricate gears are activated via a crank handle to reveal spacial alignments.
- The largest dial of the central control panel features the twelve traditional animals of the Chinese zodiac, each one indicating a different year in the 12-year cycle.
- O'Bryan, John (writer) & Volpe, Giancarlo (director). (July 14, 2006). "The Library". Avatar: The Last Airbender. Season 2. Episode 10. Nickelodeon.
- From older Avatar: The Last Airbender official site, originally on Nick.com. Encyclopedia now broken, archived at The Lost Lore of Avatar Aang - Location: Planetary Calendar Room.