diff --git a/Cargo.lock b/Cargo.lock
index 24282209e37..5befba24168 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -1294,8 +1294,10 @@ version = "0.6.0"
 dependencies = [
  "displaydoc",
  "icu",
+ "icu_calendar",
  "icu_locid",
  "icu_provider",
+ "icu_testdata",
  "serde",
  "tinystr 0.6.0",
  "zerovec",
diff --git a/components/calendar/Cargo.toml b/components/calendar/Cargo.toml
index 5635ec15062..a4851917a8c 100644
--- a/components/calendar/Cargo.toml
+++ b/components/calendar/Cargo.toml
@@ -46,3 +46,5 @@ zerovec = { version = "0.7", path = "../../utils/zerovec", default-features = fa
 
 [dev-dependencies]
 icu = { path = "../icu", default-features = false }
+icu_calendar = { version = "0.6", path = "../calendar", features = ["serde"] }
+icu_testdata = { version = "0.6", path = "../../provider/testdata" }
diff --git a/components/calendar/src/japanese.rs b/components/calendar/src/japanese.rs
index 00f90fdaca9..875d164e6ba 100644
--- a/components/calendar/src/japanese.rs
+++ b/components/calendar/src/japanese.rs
@@ -2,7 +2,45 @@
 // called LICENSE at the top level of the ICU4X source tree
 // (online at: https://github.com/unicode-org/icu4x/blob/main/LICENSE ).
 
-//! This module contains types and implementations for the Japanese calendar
+//! This module contains types and implementations for the Japanese calendar.
+//!
+//! ```rust
+//! use icu::calendar::{Date, DateTime,
+//!                     types::IsoHour, types::IsoMinute, types::IsoSecond, types::Era,
+//!                     japanese::Japanese};
+//! use tinystr::tinystr;
+//!
+//! // `icu_testdata::get_provider` contains information specifying era dates.
+//! // Production code should probably use its own data provider
+//! let provider = icu_testdata::get_provider();
+//! let japanese_calendar = Japanese::try_new(&provider)
+//!     .expect("Cannot load japanese data");
+//!
+//! // `Date` type
+//! let date_iso = Date::new_iso_date_from_integers(1970, 1, 2)
+//!     .expect("Failed to initialize ISO Date instance.");
+//! let date_japanese = Date::new_from_iso(date_iso, japanese_calendar.clone());
+//!
+//! // `DateTime` type
+//! let datetime_iso = DateTime::new_iso_datetime_from_integers(1970, 1, 2, 13, 1, 0)
+//!     .expect("Failed to initialize ISO DateTime instance.");
+//! let datetime_japanese = DateTime::new_from_iso(datetime_iso, japanese_calendar.clone());
+//!
+//! // `Date` checks
+//! assert_eq!(date_japanese.year().number, 45);
+//! assert_eq!(date_japanese.month().number, 1);
+//! assert_eq!(date_japanese.day_of_month().0, 2);
+//! assert_eq!(date_japanese.year().era, Era(tinystr!(16, "showa")));
+//!
+//! // `DateTime` type
+//! assert_eq!(datetime_japanese.date.year().number, 45);
+//! assert_eq!(datetime_japanese.date.month().number, 1);
+//! assert_eq!(datetime_japanese.date.day_of_month().0, 2);
+//! assert_eq!(datetime_japanese.date.year().era, Era(tinystr!(16, "showa")));
+//! assert_eq!(datetime_japanese.time.hour, IsoHour::new_unchecked(13));
+//! assert_eq!(datetime_japanese.time.minute, IsoMinute::new_unchecked(1));
+//! assert_eq!(datetime_japanese.time.second, IsoSecond::new_unchecked(0));
+//! ```
 
 use crate::iso::{Iso, IsoDateInner};
 use crate::provider::{self, EraStartDate};