Оставшиеся дни до даты отображаются неправильно

Обратите внимание, что Calendar.DAY_OF_MONTH возвращает день месяца от 1 до 31.

поэтому он будет вычислять разницу между двумя днями (число от 1 до 31), как если бы они были в одном месяце

Я бы предложил использовать метки времени, а затем преобразовать результат из миллисекунд в количество дней следующим образом:

long oneDay = 24 * 60 * 60 * 1000;  // in milliseconds
long diff = day.getTime().getTime() - calCurr.getTime().getTime();
long numberOfDays = diff / oneDay;

затем вы можете изменить его на String с помощью Long.toString(numberOfDays)

Java.время

java.time, современный API даты и времени Java, имеет методы для вычисления количества дней между двумя датами. Так что не утруждайте себя выполнением этого расчета. Это подвержено ошибкам.

    DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern("dd-MM-uuuu H:mm");
    String inputDateString = "01-10-2018 23:59";
    LocalDate today = LocalDate.now(ZoneId.of("Pacific/Auckland"));
    LocalDate expiration = LocalDate.parse(inputDateString, dateFormatter);
    if (expiration.isAfter(today)) {
        String numberOfDays = "Days left: " + ChronoUnit.DAYS.between(today, expiration);
        System.out.println(numberOfDays);
    }

Запустив этот фрагмент прямо сейчас (уже 13 сентября в Новой Зеландии), я получил следующий результат:

Осталось дней: 18

Пожалуйста, укажите правильный часовой пояс, если это не Pacific/Auckland.

Ответ ЛаВепе уже хорошо и правильно объяснил, что пошло не так в вашем коде, поэтому я не повторяю это.

Используемые вами классы даты и времени — Calendar и SimpleDateFormat — давно устарели и всегда были плохо спроектированы. Есть способ заставить Calendar считать дни, по 1 дню за раз, но он не очень подходит для этого. SimpleDateFormat печально известен проблемами, которые он доставил многим программистам. Я рекомендую вам вообще избегать этих классов и вместо этого использовать java.time.

Вопрос: Могу ли я использовать java.time на Android?

Да, java.time прекрасно работает на старых и новых устройствах Android. Просто требуется как минимум Java 6.

• В Java 8 и более поздних версиях, а также на более новых устройствах Android (начиная с уровня API 26, как мне сказали) современный API встроен.
• В Java 6 и 7 используйте ThreeTen Backport, бэкпорт новых классов (ThreeTen для JSR 310; см. ссылки внизу).
• На (старом) Android используйте версию ThreeTen Backport для Android. Он называется ThreeTenABP. И убедитесь, что вы импортируете классы даты и времени из org.threeten.bp с подпакетами.

Ссылки

• Ответ ЛаВепе
• Учебное пособие по Oracle: дата и время, объясняющее, как использовать java.time.
• Запрос спецификации Java (JSR) 310, где впервые было описано java.time.
• Проект ThreeTen Backport, бэкпорт java.time на Java 6 и 7 (ThreeTen для JSR-310).
• ThreeTenABP, версия ThreeTen Backport для Android
• Вопрос: как использовать ThreeTenABP в проекте Android, с очень тщательным объяснение.

Попробуйте этот метод

/**
         *  
         * @param token
         * @param date1 present date
         * @param date2 future date 
         * @return diff
         */
        public float dateDiff(String token,Date date1,Date date2){

            float diff=0;
            //different date might have different offset
            Calendar cal1=Calendar.getInstance(); 
            Calendar cal2=Calendar.getInstance();
            cal1.setTime(date1);          
            long ldate1 = date1.getTime() + cal1.get(Calendar.ZONE_OFFSET) + cal1.get(Calendar.DST_OFFSET);

            if(date2==null)
                cal2.setTime(new Date());
            else
                cal2.setTime(date2);
            long ldate2 = date2.getTime() + cal2.get(Calendar.ZONE_OFFSET) + cal2.get(Calendar.DST_OFFSET);

            // Use integer calculation, truncate the decimals
            int hr1   = (int)(ldate1/3600000); //60*60*1000
            int hr2   = (int)(ldate2/3600000);

            int days1 = hr1/24;
            int days2 = hr2/24;
            int dateDiff  = days2 - days1;
            int yearDiff  = cal2.get(Calendar.YEAR) - cal1.get(Calendar.YEAR); 
            float monthDiff = yearDiff * 12 + cal2.get(Calendar.MONTH) - cal1.get(Calendar.MONTH);
            System.out.println("monthDiff 1" +monthDiff);
            System.out.println(" days:  ;;;;222  "+dateDiff);
            float fbm = dateDiff ; 

            fbm = (float) MasterLibraryFunction.doubRound(fbm /30,2) ;

                if(token.equals("d"))
            {
                diff=dateDiff;
                System.out.println(" days:  ;;;;  "+dateDiff);
            }
            else if(token.equals("m"))
            {
                //diff= monthDiff;
                diff =fbm;
                System.out.println(" diff ---------->:  ;;;;  "+fbm);

            }

    /*******day wise diff *******/      


            return diff;
        }



/**
     * @category Decimal point round
     * @param  val
     * @param  places
     * @return Rounded Value to given place
     */
    public static double doubRound(double val, int places) {
        long factor = (long)Math.pow(10,places);
        val = val * factor;
        long tmp = Math.round(val);
        return (double)tmp / factor;
    }

Чтобы получить интервал дней между двумя днями, вы можете сделать так:

public long daysTillExpire() {

    SimpleDateFormat sdf = new SimpleDateFormat("dd-MM-yyyy");
    String dateInString = "01-10-2018 23:59";
    Date date = null;
    try {
        date = sdf.parse(dateInString);
    } catch (ParseException e) {
        e.printStackTrace();
    }

    Calendar expiredCalendar = Calendar.getInstance();
    expiredCalendar.setTime(date);

    long msDiff = expiredCalendar.getTimeInMillis() - Calendar.getInstance().getTimeInMillis();
    long daysDiff = TimeUnit.MILLISECONDS.toDays(msDiff); 

    return daysDiff;
}

вышеуказанная функция успешно протестирована, измените ее в соответствии с вашими требованиями.