feat: date picker startOnYearSelection

[Tatsunori-Morita]

Summary

This pull request addresses issue #67 by adding a feature that allows the year picker to be shown first.

Implementation details:

• For DatePickerDialog: Used an OnShowListener so that when the dialog is displayed, the year view button is retrieved via the date_picker_header_year ID and programmatically clicked to show the year selector.
• For MaterialDatePicker: Retrieved the view responsible for displaying the year within the picker’s view group and programmatically triggered it to switch to the year selection view.

Test Plan

Tested using an Android emulator.

• Pixel 6 (Android 12) DatePickerDialog

pixcel6-android12-default_WStd3B14.mp4

• Pixel 6 (Android 12) MaterialDatePicker

pixcel6-android12-material_X3kctEEi.mp4

• Pixel 7 (Android 14) DatePickerDialog

pixcel7-android14-default_D6ZmfYhW.mp4

• Pixel 7 (Android 14) MaterialDatePicker

pixcel7-android14-material_qUr9dRH2.mp4

• Nexus 5X (Android 7) DatePickerDialog

nexus5x-android7-default_bIXOxaYC.mp4

• Nexus 5X (Android 7) MaterialDatePicker

nexus5x-android7-material_W1Lry5gS.mp4

What's required for testing (prerequisites)?

What are the steps to reproduce (after prerequisites)?

Compatibility

OS	Implemented
iOS	❌
Android	✅

Checklist

• I have tested this on a device and a simulator
• I added the documentation in README.md
• I updated the typed files (TS and Flow)
• I added a sample use of the API in the example project (example/App.js)
• I have added automated tests, either in JS or e2e tests, as applicable

[vonovak]

Thanks for the PR!
Generally this seem okay. I added some comments, please take a look.

Also, I'm not quite sold on the showYearPickerFirst prop name. I'm thinking maybe startOnYearSelection, or initialSelection 'year' | 'date'... What would you suggest?

Also, tests need to pass. Maybe just re-running them will help.

Thank you!

[Tatsunori-Morita]

@vonovak
Thanks a lot for the review and the helpful comments! 🙏

I understand you’re not quite sold on the showYearPickerFirst prop name — could you clarify a bit more about what specifically doesn’t feel right with it?
Is it about potential future extensibility (for example, starting on week and so on)?

[vonovak]

@vonovak Thanks a lot for the review and the helpful comments! 🙏

I understand you’re not quite sold on the showYearPickerFirst prop name — could you clarify a bit more about what specifically doesn’t feel right with it? Is it about potential future extensibility (for example, starting on week and so on)?

@Tatsunori-Morita It's a bit subjective, I suppose. Can you rename it to startOnYearSelection? It sounds a bit more natural. Thank you!

[Tatsunori-Morita]

@vonovak
Thank you for the review!
I’ve made the requested changes.

However, some tests are still failing on CI, but I’m unable to reproduce the failures in my local environment.
Do you have any idea what might be causing this difference or what I should look into?

Thanks for your help!

[vonovak]

Thank you for the PR! The e2e tests were most likely failing due to content not fitting on screen. :)