Xamarin UI Test Date/Time Picker Extensions

AppPickerExtensions.cs

// Tested with Xamarin.UITest V1.3.7;

using System;
using Xamarin.UITest;
namespace {APPNAMEHERE}.UITests
{
    /// <summary>
    /// This extension class extends the <see cref="IApp"/> interface to add extension methods for selecting values from the default Date/Time pickers in iOS and Android.
    /// </summary>
    public static class AppPickerExtensions
    {
        /// <summary>
        /// Gets the standard timeout period.
        /// </summary>
        private static readonly TimeSpan DefaultTimeout = TimeSpan.FromSeconds(30);

        #region Android Configuration
        private const string AndroidDatePickerClass = "DatePicker";
        private const string AndroidTimePickerClass = "TimePicker";
        private const string AndroidDatePickerUpdateDateMethod = "updateDate";
        /// <summary>
        /// Gets the Android Set Minute method for the TimePicker class. As of API v 23 this is deprecated and should be replaced with "setMinute".
        /// </summary>
        private const string AndroidTimePickerSetMinuteMethod = "setCurrentMinute";
        /// <summary>
        /// Gets the Android Set Hour method for the TimePicker class. As of API v 23 this is deprecated and should be replaced with "setHour".
        /// </summary>
        private const string AndroidTimePickerSetHourMethod = "setCurrentHour";
        #endregion

        #region iOS Configuration
        private const string iOSDatePickerClass = "UIDatePicker";
        private const string iOSTableViewClass = "UIPickerTableView";

        private const int iOSDateMonthColumn = 0;
        private const int iOSDateDayColumn = 3;
        private const int iOSDateYearColumn = 6;

        private const int iOSTimeHourColumn = 0;
        private const int iOSTimeMinuteColumn = 3;
        private const int iOSTimePeriodColumn = 6;
        #endregion

        /// <summary>
        /// Updates the presented date picker with the DateTime provided.
        /// Does not request or dismiss the picker; you will need to do so yourself.
        /// </summary>
        /// <param name="app">App.</param>
        /// <param name="platform">Platform being tested.</param>
        /// <param name="dateTime">Date to be selected. Time component is ignored.</param>
        /// <param name="pickerClass">Android picker class if subclassed.</param>
        /// <param name="timeout">Timeout for picker scrolling.</param>
        public static void UpdateDatePicker(this IApp app, Platform platform, DateTime dateTime, string pickerClass = AndroidDatePickerClass, TimeSpan? timeout = null)
        {
            if (platform == Platform.Android)
            {
                app.WaitForElement(x => x.Class(AndroidDatePickerClass), timeout: DefaultTimeout);
                // Note that the month provided (4 selects it from a 0-based index, whereas the date and year are both the standard values)
                app.Query(x => x.Class(pickerClass).Invoke(AndroidDatePickerUpdateDateMethod, dateTime.Year, dateTime.Month - 1, dateTime.Day));
            }
            else if (platform == Platform.iOS)
            {
                app.WaitForElement(x => x.Class(iOSDatePickerClass), timeout: DefaultTimeout);
                ScrollToPickerColumn(app, iOSDateMonthColumn, dateTime.ToString("MMM"), timeout);
                ScrollToPickerColumn(app, iOSDateDayColumn, dateTime.ToString("d"), timeout);
                ScrollToPickerColumn(app, iOSDateYearColumn, dateTime.ToString("yyyy"), timeout);
            }
        }

        /// <summary>
        /// Updates the presented time picker with the time provided.
        /// Does not request or dismiss the picker; you will need to do so yourself.
        /// </summary>
        /// <param name="app">App.</param>
        /// <param name="platform">Platform being tested.</param>
        /// <param name="time">Time to be selected. Date component is ignored.</param>
        /// <param name="pickerClass">Android picker class if subclassed.</param>
        /// <param name="timeout">Timeout for picker scrolling.</param>
        public static void UpdateTimePicker(this IApp app, Platform platform, DateTime time, string pickerClass = AndroidTimePickerClass, TimeSpan? timeout = null)
        {
            var hours = time.Hour;
            var minute = time.Minute;
            if (platform == Platform.Android)
            {
                app.WaitForElement(x => x.Class(AndroidTimePickerClass), timeout: DefaultTimeout);
                app.Query(c => c.Class(pickerClass).Invoke(AndroidTimePickerSetHourMethod, hours));
                app.Query(c => c.Class(pickerClass).Invoke(AndroidTimePickerSetMinuteMethod, minute));
            }
            else if (platform == Platform.iOS)
            {
                // Assumes 12 Hour Clock
                app.WaitForElement(x => x.Class(iOSDatePickerClass), timeout: DefaultTimeout);
                var period = time.Hour >= 12 ? "PM" : "AM";
                ScrollToPickerColumn(app, iOSTimeHourColumn, time.ToString("h"), timeout);
                ScrollToPickerColumn(app, iOSTimeMinuteColumn, time.ToString("m"), timeout);
                ScrollToPickerColumn(app, iOSTimePeriodColumn, period, timeout);
            }
        }

        /// <summary>
        /// Scrolls to the designated picker column (for iOS only).
        /// </summary>
        /// <param name="app">App instance.</param>
        /// <param name="columnIndex">Column index to scroll to.</param>
        /// <param name="marked">Marked content to scroll to.</param>
        /// <param name="timeout">Timeout for scrolling.</param>
        private static void ScrollToPickerColumn(IApp app, int columnIndex, string marked, TimeSpan? timeout = null)
        {
            timeout = timeout ?? DefaultTimeout;
            app.ScrollDownTo(z => z.Marked(marked), x => x.Class(iOSTableViewClass).Index(columnIndex), timeout: timeout, strategy: ScrollStrategy.Auto);
            app.Tap(x => x.Text(marked));
        }
    }
}

Hi there!

I've found a bug with the date format on iOS. To fix it, should change the string format at line #64 to dateTime.ToString("MMMM") If we pass the 3rd month, March, it transforms to Mar which doesn't exist in the picker. With the fix, it's transformed to March.

The same error with the day column. You should change the format to dateTime.ToString("dd").

By the way, thank you for this code!

Regards,
Àlex MM.