Skip to main content
web-development

Android Dates and Times: A Business Requirements Brief

Specify date meaning, time zones, selectable ranges and server acceptance checks before adding calendars to a Kenyan business Android app.

Mocky Digital
November 11, 2026
7 min read

An Android date and time brief defines what a selected day or hour means in a business workflow. A delivery request, deadline and confirmed appointment can use similar-looking calendar controls while representing different commitments. A Kenyan business commissioning an app should settle those meanings before approving its date picker.

Discuss the requirements with your Android app development team. The visible selection, server record, confirmation screen and reminder should describe the same event. A well-formatted date is only one part of that consistency.

This guide covers date meaning, time-zone choices and acceptance scenarios inside an app. It is not a full booking-system specification or a promise of availability. The examples are illustrative and contain no proposed service hours or response deadlines for Mocky.

Classify each date before choosing a control

List every field involving a day, time or duration. Identify whether it represents a calendar date, an exact moment, a preferred window or a length of time. A birthday-like date and a meeting time should not automatically follow identical storage and display rules.

For each field, record the business question it answers. A requested visit date may express a preference awaiting staff acceptance. A confirmed appointment expresses a different state. The interface should not turn the first into the second merely because both can be selected on a calendar.

Name the person who approves each meaning. Product owners, operations staff and developers need a shared explanation before implementation. Keep the terminology in a field worksheet so later screen changes do not quietly redefine what a saved value represents.

State which time zone governs the task

Decide whether a time belongs to the service location, the current device or another explicitly identified zone. An appointment at a Kenyan location may need to remain tied to Africa/Nairobi even if the customer's phone is temporarily set elsewhere. Do not let an unstated assumption decide the business meaning.

Use a travelling-user example to review the rule. What should someone see before leaving Kenya, after changing the phone's zone and when opening the same confirmation on another device? Write the intended result for each step rather than asking the developer to make times look correct.

Keep calendar-only dates separate from exact moments. A deadline expressed as a day may need an additional approved end-time rule before the system can determine whether a submission is late. Do not invent that rule during implementation or infer it from the device's local midnight.

Review the picker and its labels together

Android's picker documentation describes controls for selecting dates and times and handling locale-related presentation. Use it as implementation background. A valid selection control does not establish that the business accepts the selected day or that a server has reserved anything.

Give the field a label that explains its purpose. Preferred visit date, appointment start and response deadline should not all become date. Include any important zone or review condition where the person makes the choice, instead of relying on a note hidden in a later confirmation.

Check the representation of the selected value on the summary screen. A shopper may understand a month-name date more easily than an ambiguous short numeric format. Have the team review approved wording in the languages and device settings included in scope rather than forcing one display convention without testing it.

Define selectable ranges and unavailable periods

Record which past and future dates are permitted and why. Some tasks may allow historical entry, while others require a future selection. Specify the difference in the business worksheet instead of applying one global rule to every calendar in the app.

Where unavailable days or time windows appear, identify their authoritative source. Staff availability, a location's operating calendar and a customer's preference are different inputs. Ask how the interface updates when the source changes and what the customer sees if an earlier choice is no longer acceptable.

Keep selection and confirmation separate. A slot visible on a device can become unavailable before the person submits. Require a trusted server check for rules and any reservation. The app should explain a changed condition without pretending that an outdated calendar screen guarantees acceptance.

Specify duration, buffers and boundaries

If the event has a duration, decide how the end is determined. Is it selected independently, calculated from an approved service length or confirmed later by staff? Show the start and end relationship clearly enough for both the customer and operations team to understand.

Record whether any buffer belongs to internal scheduling rather than the public service duration. A staff preparation interval may affect availability without changing what the customer receives. Keep those concepts separate so a calendar display does not accidentally add an unapproved promise to the offer.

Test boundaries explicitly. Include an event crossing midnight, a selection at the last permitted time and a request made near a cut-off. Use illustrative review data and the actual approved business rules. The purpose is to resolve ambiguity, not to manufacture opening hours simply to complete a test sheet.

Plan edits, cancellation and reminders consistently

Decide who may change the selected value and when another approval is required. A customer request to reschedule may need staff acceptance. The app should distinguish the existing confirmed arrangement from a proposed replacement while that decision is pending.

Check every place the value appears after a change. The main record, confirmation message and reminders should refer to the current approved arrangement. An older alert should not continue instructing someone to attend a cancelled time without an appropriate explanation when they open it.

Coordinate with the Android notification preferences brief. Reminders depend on both timing rules and the permitted notification journey. Do not treat an attempted reminder as proof that the person read it or accepted a changed appointment.

Keep device time separate from trusted decisions

Describe what happens if the phone clock is inaccurate or changed manually. A local display may help the person choose, but the server should enforce rules that determine acceptance, expiry or access. Ask the developer to demonstrate how the relevant decisions are made without trusting a browser or phone to establish a business deadline.

Include an interrupted connection scenario. Someone might prepare a request while offline and reconnect after the chosen time has passed. The system should recheck the request and explain what needs review rather than silently submitting an obsolete preference as though it were still valid.

Use the Android offline requirements brief to distinguish locally saved preparation from server acceptance. The date worksheet should name the relevant revalidation rules while the offline brief records the broader draft and synchronisation journey.

Build a small cross-device acceptance matrix

Prepare columns for field meaning, governing zone, device setting, selected value, expected server interpretation and visible confirmation. Include two accounts where appropriate, a device-zone change and the supported date or time display preferences. Use controlled data without importing private appointment details into the project brief.

Test editing a saved selection and reopening it on another device. Include a rejected value, an unavailable slot and a stale draft. Record both what the person sees and the business record produced. A correct calendar screenshot alone cannot prove that the saved event has the intended meaning.

Keep the matrix with the release documentation. Review Mocky's app portfolio for background and request an app development quotation with the field meanings, time-zone decisions and acceptance work included. That gives the team a concrete scope beyond adding a calendar icon.

Frequently asked questions

Should all dates use the phone's current time zone?

Choose according to the field's meaning. A location-bound appointment and a calendar-only reference can require different treatment. State the intended behaviour explicitly.

Does selecting a time confirm availability?

Only if the agreed workflow performs and records the required checks. Keep a preference, temporary reservation and confirmed event visibly distinct.

What if a user changes the phone clock?

Trusted business decisions should use the appropriate server validation. Include the altered-clock scenario in acceptance testing rather than assuming device time is authoritative.

Is this enough to specify a booking system?

No. Staffing, capacity, payment, cancellation and other business rules need their own scope. This worksheet establishes the meaning and consistent handling of the date and time fields within that wider workflow.

Share this article

Ready to Start Your Project?

Tell us what you need designed, built, or printed. We will reply with a clear price and timeline.

Book a Call

Preparing your booking calendar…

Having trouble? Open the booking calendar directly.

Mocky Digital

Let’s talk about your project

Choose a service and leave your details. We’ll follow up with you.

By submitting, I agree that Mocky Digital may save my details on its website and in Cal CRM and email me relevant service tips and offers. I can unsubscribe at any time.

Your details are used to respond to your enquiry. Privacy policy.